> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Economic Calendar > Returns the macroeconomic releases scheduled in a window: inflation, growth, employment, central bank decisions and the rest of the economic calendar, for the countries requested. Each release carries the figure published, the market consensus and the prior period, so a caller can see both what was expected and what landed. Figures are returned in full units. There is no pagination, and a response is capped at 1000 releases, so narrow the window or the filters to stay under it. ## OpenAPI ````yaml /api-rest/openapi/openapi_structured_data.json post /v1/economic-calendar/query openapi: 3.1.0 info: title: Bigdata Structured Data API description: Bigdata API documentation version: 1.0.0 servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] tags: - name: Market Data description: >- Market data endpoints including intraday prices, daily prices, price changes, and real-time quotes - name: Analyst Estimates description: >- Analyst estimates and ratings including analyst ratings, estimates, target prices, and earnings surprises - name: Financials & Ratios description: >- Financial statements and ratios including balance sheet, income statement, cash flow statement, key metrics TTM, and company ratios TTM - name: Company & Events description: >- Company information and events including company profile and events calendar - name: Fund Holdings description: >- Institutional fund holdings from SEC 13F filings including fund holdings and stock fund holdings - name: Knowledge Graph description: Corporate ownership and hierarchy data. paths: /v1/economic-calendar/query: post: tags: - Company & Events summary: Economic Calendar description: >- Returns the macroeconomic releases scheduled in a window: inflation, growth, employment, central bank decisions and the rest of the economic calendar, for the countries requested. Each release carries the figure published, the market consensus and the prior period, so a caller can see both what was expected and what landed. Figures are returned in full units. There is no pagination, and a response is capped at 1000 releases, so narrow the window or the filters to stay under it. operationId: query_economic_calendar_v1_economic_calendar_query__post requestBody: content: application/json: schema: $ref: '#/components/schemas/EconomicCalendarQuery' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EconomicCalendarResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/BadRequestError' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' components: schemas: EconomicCalendarQuery: properties: start_date: type: string format: date title: Start Date description: First day of the window, as YYYY-MM-DD. Inclusive. examples: - '2026-01-01' end_date: type: string format: date title: End Date description: Last day of the window, as YYYY-MM-DD. Inclusive. examples: - '2026-01-31' countries: anyOf: - items: $ref: '#/components/schemas/EconomicCalendarCountryCode' type: array - type: 'null' title: Countries description: >- Countries to return releases for, as ISO 3166-1 alpha-2 codes (case-insensitive). 'UK' is accepted as an alias for 'GB' and returned as 'GB'. The sole non-ISO code is 'EMU' (euro area), which carries ECB decisions and euro-area aggregates. Omit to cover all countries. examples: - - US - GB - EMU impacts: anyOf: - items: $ref: '#/components/schemas/ImpactLevel' type: array - type: 'null' title: Impacts description: >- Expected market impact levels to return. Omit for every level. Case does not matter. examples: - - HIGH - MEDIUM categories: anyOf: - items: $ref: '#/components/schemas/EconomicCategory' type: array - type: 'null' title: Categories description: >- Categories to filter by. Omit for every category. Case does not matter. examples: - - Inflation - Labor Market additionalProperties: false type: object required: - start_date - end_date title: EconomicCalendarQuery example: categories: - Inflation - Labor Market countries: - US - GB - EMU end_date: '2026-01-31' impacts: - HIGH - MEDIUM start_date: '2026-01-01' EconomicCalendarResponse: properties: results: items: $ref: '#/components/schemas/EconomicEvent' type: array title: Results description: >- The releases in the requested window, ordered by date then country. There is no pagination: the provider serves no cursor, so there is nothing to resume from. A response is capped at 1000 releases and the earliest are kept, so a window that comes back with exactly 1000 may have more that were not returned. Narrow the date range, the countries or the impact levels to stay under it. errors: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Errors metadata: anyOf: - $ref: '#/components/schemas/Metadata' - type: 'null' type: object required: - results title: EconomicCalendarResponse example: results: - actual: 250000 actual_is_preliminary: false category: Labor Market communication_types: [] consensus: 200000 country: US event_datetime: '2026-02-10T13:30:00Z' impact: HIGH is_all_day: false is_better_than_expected: true is_tentative: false name: Nonfarm Payrolls period_date: '2026-01-01' period_type: MONTH previous: 180000 previous_is_preliminary: false ratio_deviation: 0.25 surprise: 25 BadRequestError: properties: statusCode: type: integer const: 400 title: Statuscode default: 400 message: type: string title: Message type: object required: - message title: BadRequestError description: Bad Request Error example: message: Bad Request Error statusCode: 400 TooManyRequestsError: properties: statusCode: type: integer const: 429 title: Statuscode default: 429 message: type: string title: Message type: object required: - message title: TooManyRequestsError description: Too many requests. Please try again later. example: message: Too many requests. Please try again later. statusCode: 429 InternalServerError: properties: statusCode: type: integer const: 500 title: Statuscode default: 500 message: type: string title: Message type: object required: - message title: InternalServerError description: Internal Server Error example: message: Internal Server Error statusCode: 500 EconomicCalendarCountryCode: type: string enum: - AE - AR - AT - AU - BE - BR - CA - CH - CL - CN - CO - CZ - DE - DK - EG - EMU - ES - FI - FR - GB - GR - HK - HU - ID - IE - IL - IN - IS - IT - JP - KR - KW - MX - NL - 'NO' - NZ - PL - PT - QA - RO - RU - SA - SE - SG - SK - TH - TR - UA - UK - US - VN - ZA title: EconomicCalendarCountryCode ImpactLevel: type: string enum: - NONE - LOW - MEDIUM - HIGH title: ImpactLevel description: |- How much movement the provider expects a release to cause. Requests are normalised onto these by the validator that accepts them. EconomicCategory: type: string enum: - Bond Auctions - Capital Flows - Central Banks - Consumption - Economic Activity - Energy - Holidays - Housing Market - Inflation - Interest Rates - Labor Market - Politics title: EconomicCategory description: >- The categories FXStreet groups its indicators into. Restated here rather than imported, as the countries are: this lambda is a proxy and shares no code with the internal service. The provider's own identifier for each is the internal service's business, not a caller's. A request is normalised onto these by the validator that accepts it, and the canonical spelling is what is forwarded. This check runs first, so a spelling refused here never reaches the internal endpoint. EconomicEvent: properties: event_datetime: type: string format: date-time title: Event Datetime description: When the figure is released, in ISO 8601 format (UTC). examples: - '2026-02-10T13:30:00Z' country: type: string title: Country description: >- Country the release covers. Every value is an ISO 3166-1 alpha-2 code except one: 'EMU', the euro area, which has no ISO code of its own. examples: - US name: type: string title: Name description: Name of the economic indicator. examples: - Nonfarm Payrolls impact: anyOf: - $ref: '#/components/schemas/ImpactLevel' - type: 'null' description: 'Expected market impact: NONE, LOW, MEDIUM or HIGH.' examples: - HIGH period_date: anyOf: - type: string format: date - type: 'null' title: Period Date description: >- The period the figure describes, as 'YYYY-MM-DD', which is not when it was released: a December CPI published in January describes December. Read it with 'period_type', which says whether the period is that day, its month or its quarter. Absent on an event with no period, such as a central bank speech. examples: - '2026-01-01' period_type: anyOf: - $ref: '#/components/schemas/PeriodType' - type: 'null' description: >- Granularity of the period: DAY, MONTH or QUARTER. 'NONE' on a release that has no period behind it, such as a central bank speech, where 'period_date' is absent too. examples: - MONTH actual: anyOf: - type: number - type: 'null' title: Actual description: >- The released figure, in full units. Absent until the release happens, which is the usual state for a forward-looking window. examples: - 250000 consensus: anyOf: - type: number - type: 'null' title: Consensus description: Market expectation, in full units. examples: - 200000 previous: anyOf: - type: number - type: 'null' title: Previous description: The prior period's figure, in full units. examples: - 180000 revised: anyOf: - type: number - type: 'null' title: Revised description: >- The prior period restated, in full units. When present, 'previous' is the figure as first published and this is the corrected one. examples: - 185000 ratio_deviation: anyOf: - type: number - type: 'null' title: Ratio Deviation description: >- The provider's own measure of how far the released figure fell from consensus, as a ratio. Published by FXStreet alongside the figures; 'surprise' is the same idea expressed as a signed percentage. examples: - 0.25 surprise: anyOf: - type: number - type: 'null' title: Surprise description: >- Percentage by which the released figure beat or missed the consensus, signed. Absent when either figure is. examples: - 25 is_better_than_expected: anyOf: - type: boolean - type: 'null' title: Is Better Than Expected description: >- Whether the result is good for the economy, as judged by the provider. Direction-aware, unlike 'surprise': a lower unemployment print is a negative surprise and better than expected. examples: - true unit: anyOf: - type: string - type: 'null' title: Unit description: >- What the figures are measured in: '%' for a rate, '$' for a monetary value, absent for a count such as jobs. examples: - '%' category: anyOf: - $ref: '#/components/schemas/EconomicCategory' - type: 'null' description: >- The category this indicator is filed under, named the same way the 'categories' filter names one. Absent when the provider filed the event under no category. examples: - Labor Market communication_types: items: $ref: '#/components/schemas/CommunicationType' type: array title: Communication Types description: >- The prose forms this entry takes: 'REPORT' for a published document, 'SPEECH' for spoken remarks, and both when it is both. Empty on an ordinary data release, which is most of a calendar. examples: - - SPEECH is_all_day: anyOf: - type: boolean - type: 'null' title: Is All Day description: >- Whether the event covers the whole day rather than a moment in it. When true, the time of day carried by 'event_datetime' is a convention and not a release time. examples: - false is_tentative: anyOf: - type: boolean - type: 'null' title: Is Tentative description: >- Whether the timing is provisional. When true, 'event_datetime' is the provider's best estimate of when the figure lands rather than a scheduled time, so do not rely on it to the minute. examples: - false actual_is_preliminary: anyOf: - type: boolean - type: 'null' title: Actual Is Preliminary description: >- Whether 'actual' is a first estimate. A preliminary figure is normally restated in a later release. examples: - false previous_is_preliminary: anyOf: - type: boolean - type: 'null' title: Previous Is Preliminary description: >- Whether 'previous' is a first estimate rather than a settled figure. This is what a value in 'revised' corrects. examples: - false type: object required: - event_datetime - country - name title: EconomicEvent ErrorDetail: properties: message: anyOf: - type: string - type: 'null' title: Message type: object title: ErrorDetail Metadata: properties: request_id: type: string title: Request Id timestamp: type: string title: Timestamp type: object required: - request_id title: Metadata PeriodType: type: string enum: - NONE - DAY - MONTH - QUARTER title: PeriodType description: >- The granularity of the period a figure describes. ``NONE`` is how a release with no period behind it is reported, such as a central bank speech. It arrives as this name rather than as null, and those releases carry no ``period_date`` either. CommunicationType: type: string enum: - REPORT - SPEECH title: CommunicationType description: >- A form an entry takes when it is prose rather than a figure. The provider flags the two independently and may set both, so a row carries them as a list rather than choosing between them. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````