CLclear-street
Calendar

Get Economic Calendar Events

Changed on

Retrieves macroeconomic calendar events (e.g. CPI, jobs reports, central bank rate decisions), optionally filtered by country, impact, and event time range.

Absent a timestamp lower bound, results default to events from the start of the previous trading day (America/New_York); absent an upper bound, results default through 7 days from today (America/New_York).

get/v1/calendars/economic-events

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Query parameters

countrystring

Comma-separated ISO 3166-1 alpha-2 country codes (or EU) to filter by. Defaults to US when omitted.

impactstring[]

Comma-separated impact levels to filter by.

timestamp.gtstring

Return only rows where timestamp is strictly after the given value. A bare YYYY-MM-DD date expands to the end of that day (UTC), so this matches from the start of the following day. See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

timestamp.gtestring

Return only rows where timestamp is on or after the given value. A bare YYYY-MM-DD date expands to the start of that day (UTC). See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

timestamp.ltstring

Return only rows where timestamp is strictly before the given value. A bare YYYY-MM-DD date expands to the start of that day (UTC). See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

timestamp.ltestring

Return only rows where timestamp is on or before the given value. A bare YYYY-MM-DD date expands to the end of that day (UTC), so this matches through the end of that day. See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

page_sizeinteger

The number of items to return per page. Only used when page_token is not provided.

page_tokenstring byte

Base64URL-encoded pagination token

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

Response

Economic calendar events

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": [
    {
      "actual": null,
      "change": null,
      "change_percentage": null,
      "country": "US",
      "currency": "USD",
      "estimate": "0.30",
      "impact": "HIGH",
      "name": "CPI m/m",
      "previous": "0.20",
      "timestamp": "2026-09-25T12:30:00.000000000Z",
      "unit": "%"
    }
  ]
}

Changes