Skip to main content
POST
Economic Calendar

Authorizations

X-API-KEY
string
header
required

Body

application/json
start_date
string<date>
required

First day of the window, as YYYY-MM-DD. Inclusive.

Example:

"2026-01-01"

end_date
string<date>
required

Last day of the window, as YYYY-MM-DD. Inclusive.

Example:

"2026-01-31"

countries
enum<string>[] | null

Countries to return releases for, as ISO 3166-1 alpha-2 codes (case-insensitive). 'UK' is accepted as an alias for 'GB' and returned as 'GB'. The sole non-ISO code is 'EMU' (euro area), which carries ECB decisions and euro-area aggregates. Omit to cover all countries.

Available options:
AE,
AR,
AT,
AU,
BE,
BR,
CA,
CH,
CL,
CN,
CO,
CZ,
DE,
DK,
EG,
EMU,
ES,
FI,
FR,
GB,
GR,
HK,
HU,
ID,
IE,
IL,
IN,
IS,
IT,
JP,
KR,
KW,
MX,
NL,
NO,
NZ,
PL,
PT,
QA,
RO,
RU,
SA,
SE,
SG,
SK,
TH,
TR,
UA,
UK,
US,
VN,
ZA
Example:
impacts
enum<string>[] | null

Expected market impact levels to return. Omit for every level. Case does not matter.

How much movement the provider expects a release to cause.

Requests are normalised onto these by the validator that accepts them.

Available options:
NONE,
LOW,
MEDIUM,
HIGH
Example:
categories
enum<string>[] | null

Categories to filter by. Omit for every category. Case does not matter.

The categories FXStreet groups its indicators into.

Restated here rather than imported, as the countries are: this lambda is a proxy and shares no code with the internal service. The provider's own identifier for each is the internal service's business, not a caller's.

A request is normalised onto these by the validator that accepts it, and the canonical spelling is what is forwarded. This check runs first, so a spelling refused here never reaches the internal endpoint.

Available options:
Bond Auctions,
Capital Flows,
Central Banks,
Consumption,
Economic Activity,
Energy,
Holidays,
Housing Market,
Inflation,
Interest Rates,
Labor Market,
Politics
Example:

Response

Successful Response

results
EconomicEvent · object[]
required

The releases in the requested window, ordered by date then country. There is no pagination: the provider serves no cursor, so there is nothing to resume from. A response is capped at 1000 releases and the earliest are kept, so a window that comes back with exactly 1000 may have more that were not returned. Narrow the date range, the countries or the impact levels to stay under it.

errors
ErrorDetail · object[] | null
metadata
Metadata · object | null