API documentation

get/api/v1/Instruments/research/calendars/economic

Returns macro economic calendar events (country, impact, estimates) within a UTC window.

Country scoping: an event is returned when its country matches {country}/{countries} or the primary country derived from {currencies}. Set {byCurrency=true} to additionally match on the event {Currency} field (all eurozone national releases for EUR, etc.). Supplying no country/currency returns all countries. Typical chat usage: {?from=..&to=..&importance=high&currencies=EUR,USD} (narrow: EU + US).

Instruments

Parameters

from

query · string

Optional

query · string

Optional

country

query · string

Optional

importance

query · string

Optional

query · string

Optional

countries

query · string

Optional

currencies

query · string

Optional

byCurrency

query · boolean

Optional

version

path · string

Required

Responses

200Array of calendar events.application/json

[
  {
    "eventType": "economic",
    "eventUtc": "2026-06-30T12:30:00Z",
    "country": "US",
    "currency": "USD",
    "symbol": null,
    "title": "Non-Farm Payrolls",
    "importance": "high",
    "actual": null,
    "estimate": "180K",
    "previous": "175K"
  }
]

API documentation

Parameters

Responses

أطلق منصتك.