Skip to content
Clear Street Clear Street Clear Street
Start Trading
API Reference
V1
Calendar

Get Economic Calendar Events

CalendarGetEconomicEventsCalendarResponse v1().calendar().getEconomicEventsCalendar(CalendarGetEconomicEventsCalendarParamsparams = CalendarGetEconomicEventsCalendarParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/calendars/economic-events

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).

ParametersExpand Collapse
CalendarGetEconomicEventsCalendarParams params
Optional<String> country

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

Optional<List<Impact>> impact

Comma-separated impact levels to filter by.

NONE("NONE")
LOW("LOW")
MEDIUM("MEDIUM")
HIGH("HIGH")
Optional<Long> pageSize

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

formatint64
maximum10000
minimum1
Optional<String> pageToken

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

formatbyte
Optional<Timestamp> timestamp
Optional<String> gt

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.

Optional<String> gte

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.

Optional<String> lt

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.

Optional<String> lte

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.

ReturnsExpand Collapse
class CalendarGetEconomicEventsCalendarResponse:
List<EconomicEvent> data
String country

ISO 3166-1 alpha-2 country code, or EU.

String name

Event name as reported by the provider.

LocalDateTime timestamp

UTC instant of the event.

formatdate-time
Optional<String> actual

Actual reported value. Null before the print, or if the provider never reports one for this event. When a null/undefined value is observed, it indicates that there is no available data.

Optional<String> change

Change from the previous value. When a null/undefined value is observed, it indicates that there is no available data.

Optional<String> changePercentage

Change from the previous value, as a percentage. When a null/undefined value is observed, it indicates that there is no available data.

Optional<String> currency

Currency associated with the event, if applicable. When a null/undefined value is observed, it indicates that there is no available data.

Optional<String> estimate

Analyst-estimated value. When a null/undefined value is observed, it indicates that there is no available data.

Optional<EconomicEventImpact> impact

Expected market impact, if known. When a null/undefined value is observed, it indicates that there is no available data.

One of the following:
NONE("NONE")
LOW("LOW")
MEDIUM("MEDIUM")
HIGH("HIGH")

Previous period’s reported value. When a null/undefined value is observed, it indicates that there is no available data.

Optional<String> unit

Unit of the numeric value fields, if known. When a null/undefined value is observed, it indicates that there is no available data.

Get Economic Calendar Events

package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.calendar.CalendarGetEconomicEventsCalendarParams;
import com.clearstreet.api.models.v1.calendar.CalendarGetEconomicEventsCalendarResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        CalendarGetEconomicEventsCalendarResponse response = client.v1().calendar().getEconomicEventsCalendar();
    }
}
{
  "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": "2025-11-05T13:30:00.000000000Z",
      "unit": "%"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "0f1a2b3c-4d5e-6f78-9012-3a4b5c6d7e8f"
  }
}
Returns Examples
{
  "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": "2025-11-05T13:30:00.000000000Z",
      "unit": "%"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "0f1a2b3c-4d5e-6f78-9012-3a4b5c6d7e8f"
  }
}