Developer Portal
Trader APIsHTTP APIData

Get Economic CalendarGET

Returns economic calendar events, optionally scoped to a symbol. When a symbol_id is supplied, relevance is determined by the symbol's base and quote assets (currency filter) and its asset class (category filter); when omitted, all events in the window are returned. An explicit currencies or categories param overrides the symbol-derived defaults. Results can be bounded by a from/to date range. No authentication required.

View as Markdown
GET
/public/economic-calendar

Query Parameters

symbol_idstring

Optional symbol ID. Its base/quote assets select relevant currencies and its asset class selects a default category set. Omit for an unscoped calendar.

currenciesstring

Comma-separated list of currency codes to filter by (e.g. EUR,USD). Overrides the symbol-derived currency filter. Empty or omitted leaves currency scoping to the symbol (if any).

fromstring

Lower bound (inclusive) for event dates, RFC3339 or YYYY-MM-DD. Defaults to 30 days ago when omitted.

Format: "date-time"
tostring

Upper bound (inclusive) for event dates, RFC3339 or YYYY-MM-DD. Defaults to 7 days from now when omitted.

Format: "date-time"
categoriesstring

Comma-separated list of economic categories to filter by. When omitted, the relevant categories are derived automatically from the symbol's asset class (forex, stock/ETF/index, and commodity each get a tailored set; other classes such as crypto are left unfiltered). Passing this param overrides that default. Unknown names are ignored. Allowed values: MONETARY_POLICY, INFLATION, EMPLOYMENT, GROWTH_OUTPUT, BUSINESS_ACTIVITY, CONSUMER, TRADE, HOUSING, MONEY_CREDIT, GOVERNMENT_FINANCE, ENERGY, COMMODITIES, MARKET_POSITIONING, OTHER.

curl -X GET "http://localhost:8081/api/v1/public/economic-calendar?symbol_id=%3Cstring%3E&currencies=%3Cstring%3E&from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z&categories=%3Cstring%3E"

Economic calendar events relevant to the symbol

{
  "events": [
    {
      "date": "string",
      "country": "string",
      "currency": "string",
      "event": "string",
      "impact": "string",
      "previous": 0.1,
      "estimate": 0.1,
      "actual": 0.1,
      "change": 0.1,
      "change_percentage": 0.1,
      "unit": "string",
      "is_past": true,
      "category": "string",
      "relevance_tier": "string"
    }
  ]
}

Symbols

Returns a list of trading symbols for a specific account group, enriched with template data. Optionally filterable by a list of symbol IDs.

Exchange Rates

Returns the current conversion rate between two currencies. Use it to convert balances, PnL or margin figures from an account's currency into another, for example USD to EUR.