Skip to main content
GET
Market events

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Path Parameters

id
string
required

Ticker symbol (e.g. NVDA), numeric SEC CIK (zero-padding optional), or the platform key of a non-SEC issuer (e.g. XSAU000001 — the cik field of the company payload). A bare ticker always resolves to the SEC registrant.

Query Parameters

max_tier
integer
default:3

Least important tier to include, 1–3, default 3; any other value is read as 3.

Required range: 1 <= x <= 3
economy
string

ISO alpha-2 economy for economic events (recessions); default the home country, else US.

category
string

Categories, comma-separated, e.g. war_conflict,financial_crisis.

exclude_category
string

Categories to drop, e.g. calendar (Ramadan).

from
string<date>

First day (events overlapping the window), YYYY-MM-DD.

to
string<date>

Last day, YYYY-MM-DD.

limit
integer

Page size, 1–500.

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

Rows to skip, default 0.

Required range: x >= 0
order
enum<string>

Date order: asc oldest first (the default), desc newest first.

Available options:
asc,
desc

Response

OK

Inferred from captured responses: every field shown was returned by a real call; a field may be absent or null on other calls.

cik
string
economy
string
economies
string[]
events
object[]
total
integer
offset
integer
nextOffset
integer
limit
integer
hasMore
boolean
order
string