---
title: "Earnings and Economic Calendar"
method: GET
path: "/calendar"
tags: ["market-data"]
---

# Earnings and Economic Calendar

`GET /calendar`

## Request

- Base URL: `https://api.qfex.com`
- URL: `https://api.qfex.com/calendar`
- Auth: none required

Return company earnings and economic events for an inclusive date range of up to 93 days. No authentication is required. Earnings use report dates; economic events use their stored calendar dates. For timezone-aware weekly displays, include one extra date on either side and group exact release timestamps in the desired timezone. Unknown release times remain null. Economic sync freshness is returned separately from earnings. See /refdata for symbol market_hours and /market-holidays for reference-market holiday dates. Earnings metadata omits source attribution fields, including nested release-time sources. Pin api_version=2026-10-29 to retain the historical metadata.

## Query parameters

- `from` string, date, required: First report/event date, inclusive (YYYY-MM-DD).
- `to` string, date, required: Last report/event date, inclusive. Maximum 93 days per request.
- `api_version` string

## Response `200`

OK

- CalendarData
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `earnings` CalendarEarnings[], nullable, required
    - `body` string, nullable, required
    - `eps_actual` number, double, nullable, required
    - `eps_estimate` number, double, nullable, required
    - `id` string, required
    - `metadata` object, required
    - `report_date` string, date, required
    - `revenue_actual` number, double, nullable, required
    - `revenue_estimate` number, double, nullable, required
    - `symbol` string, required
    - `title` string, nullable, required
  - `economic` CalendarEconomicData, required
    - `events` CalendarEconomicEvent[], nullable, required
      - `actual` unknown, required
      - `consensus` unknown, required
      - `country` string, required: Two-letter country/region code; EU denotes the euro area.
      - `data_stale` boolean, required
      - `date` string, date, required
      - `id` string, required
      - `impact` string, nullable, required
      - `last_verified_at` string, nullable, required
      - `name` string, required
      - `period` string, nullable, required
      - `prior` unknown, required
      - `release_at_utc` string, date-time, nullable, required
      - `release_stage` string, nullable, required
      - `series_code` string, required
      - `source_name` string, nullable, required
      - `source_url` string, nullable, required
      - `status` string, required
      - `unit` string, nullable, required
      - `url` string, nullable, required
    - `fetchedAt` string, date-time, nullable, required: Last successful economic calendar sync, or null before the first sync.
    - `stale` boolean, required: True before the first sync or when the last sync is over one hour old.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `0c23dfc24573`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qfex/apis/qfex-rest-api/changes/calendar/get.md)

---

[API](https://skmtc.dev/qfex/apis/qfex-rest-api.md) - [All operations](https://skmtc.dev/qfex/apis/qfex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qfex/apis/qfex-rest-api/revisions/0c23dfc24573?raw)