Skip to main content
GET
Get Market News

Authorizations

X-API-Key
string
header
required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol
string

Stock symbol filter (optional)

topic
enum<string>

Topic filter (optional; energy_transportation, real_estate and retail_wholesale are deprecated aliases)

Available options:
blockchain,
earnings,
economy_fiscal,
economy_macro,
economy_monetary,
energy_and_transportation,
finance,
financial_markets,
ipo,
life_sciences,
manufacturing,
mergers_and_acquisitions,
real_estate_and_construction,
retail_and_wholesale,
technology,
energy_transportation,
real_estate,
retail_wholesale
source
string

Media source filter (optional, e.g. Reuters, Bloomberg, CNBC)

start_time
integer<int64>

Start time (Unix seconds); required unless updated_after/updated_before are given, in which case it narrows publish_time as an optional filter

end_time
integer<int64>

End time (Unix seconds); required unless updated_after/updated_before are given, in which case it narrows publish_time as an optional filter

sort_by_type
enum<string>

Sort by type: PUBLISHED_TIME, OVERALL_SENTIMENT_SCORE, or RELEVANCE_SCORE (default: PUBLISHED_TIME)

Available options:
PUBLISHED_TIME,
OVERALL_SENTIMENT_SCORE,
RELEVANCE_SCORE
sort_by
enum<string>

Sort order: ASC or DESC (default: DESC)

Available options:
ASC,
DESC
limit
integer
default:10

Maximum number of results (1-100, default: 10)

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset (>=0, default: 0)

Required range: x >= 0
updated_after
integer<int64>

Inclusive article update bound (Unix seconds); requires updated_before

updated_before
integer<int64>

Exclusive article update bound (Unix seconds); must exceed updated_after

cursor
string

Opaque update-window continuation; incompatible with offset

Response

List of market news articles

data
object[]
error
object
metadata
any
pagination
any
request_id
string
success
boolean