v1

latestOpenAPI 3.0.32026-07-246185298.2 KB

Macro events

List of macro events

Provides a list of significant macroeconomic events, including key metrics and country-specific information.

Available Data Points:

Title: Short descriptive title of the event.
Date: The date of the event in `YYYY-MM-DD` format.
Datetime: The exact date and time in `YYYY-MM-DDTHH:mm:ssZ` format (ISO 8601), if applicable.
Actual Value: Reported or observed value for the event.
Expectation: Forecast or expected value for the event.
Surprise: Comparison or difference between actual and expected values.
Previous: Value reported during the previous reporting period.
Country iso2: Two-letter ISO country code (e.g., US, UK, DE).
Category: Broad classification of the event (e.g., GDP, inflation, employment).

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: A list of randomly selected rows will be returned

Get full access! Get a key at app.ortex.com/apis

get/api/v1/macro_events

Query parameters

countrystring required

Country ISO-2 code

from_datestring

Events from date in format yyyy-mm-dd. Default: one month back from to_date

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

to_datestring

Events to date in format yyyy-mm-dd. Default: today. Maximum date range is 1 month

Response

paginationLinksobject

lengthinteger required

creditsUsedinteger

creditsLeftinteger

Example response

{
  "paginationLinks": {
    "next": "http://api.example.org/accounts/?page=4",
    "previous": "http://api.example.org/accounts/?page=2"
  },
  "length": 123,
  "creditsUsed": 3,
  "creditsLeft": 999
}