MEmetacopier
News API

Get economic calendar events

Changed on

The calendar is global and identical for every project. Without from/to the current day plus seven days is returned.

get/rest/api/v1/projects/{projectId}/economicCalendar

Request

Path parameters

projectIdstring uuid required

Query parameters

fromstring

Start of the range (ISO-8601 UTC)

tostring

End of the range (ISO-8601 UTC)

currenciesstring

Comma separated currency codes

countriesstring

Comma separated ISO-2 country codes

impactstring

Minimum impact: HOLIDAY, LOW, MEDIUM or HIGH

searchstring

Case insensitive substring of the event title

pageinteger

Zero based page index

sizeinteger

Page size, maximum 100

Response

OK

lastSyncUtcstring date-time

When the ingestion last wrote anything, null means it never ran

nextEventTitlestring

Title of the event behind nextEventUtc

nextEventUtcstring date-time

First matching event after the requested range, so an empty page is never a dead end

pageinteger

Zero based page index

sizeinteger

Page size

totalinteger

Total number of matching events

Example response

{
  "items": [
    {
      "actual": "0.3%",
      "actualRaw": 0.3,
      "category": "prce",
      "countryCode": "US",
      "currencyCode": "USD",
      "forecast": "0.2%",
      "forecastRaw": 0.2,
      "indicator": "core cpi mm",
      "indicatorKey": "US|core cpi mm",
      "period": "Jul",
      "previous": "0.1%",
      "previousRaw": 0.1,
      "revision": 1,
      "revisions": [
        {
          "field": "eventTimeUtc",
          "newValue": "2026-08-12T14:30:00Z",
          "oldValue": "2026-08-12T12:30:00Z"
        }
      ],
      "scale": "K",
      "surpriseSigma": 2.4,
      "title": "Core CPI m/m",
      "unit": "%"
    }
  ],
  "nextEventTitle": "Non-Farm Payrolls",
  "size": 25,
  "total": 134
}

Changes