API Documentation

⌘K
Get Started
APIs
Get free key
GET/api/1/macro/calendar

Macro Calendar API

Macro events in a given timeframe and set of countries.

Defaults

language=enstart=last

Related endpoints

Parameters

Required first. Documented defaults are selected — Test Request matches a bare call.

4
languagestringdefault en
query

Default en

start[ "number", "string", "null" ]default last
query

Start of window: ms timestamp or ISO date (e.g. 2026-08-01). Default: last 7 days.

Default last

end[ "number", "string", "null" ]optional
query

End of window: ms timestamp or ISO date (e.g. 2026-09-15).

Optional. Omit to skip.

countriesstringoptional
query

Comma separated list of country_codes

Optional. Omit to skip.

Responses

Was this helpful?
Request
curl -X GET \
  'https://api.eulerpool.com/api/1/macro/calendar?language=en&start=last' \
  -H 'Accept: application/json'
200 Response
[
  {
  "name": "API Crude Oil Inventory Change",
  "country_code": "us",
  "timestamp": 1729110600000,
  "actual_currency": "usd",
  "actual_value": 1,
  "actual_multiplier": 1000,
  "previous_currency": "usd",
  "previous_value": 0.5,
  "previous_multiplier": 1000,
  "consensus_currency": "usd",
  "consensus_value": 0.5,
  "consensus_multiplier": 1000,
  "forecast_currency": "usd",
  "forecast_value": 0.8,
  "forecast_multiplier": 1000,
  "full_day": "usd",
  "reference_date": "usd"
}
]