{
"message": "Too many requests. Please try again later.",
"statusCode": 429
}
{
"message": "Internal Server Error",
"statusCode": 500
}
Company & Events
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.
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.
Categories to filter by. Valid values: bond-auctions, capital-flows, central-banks, consumption, economic-activity, energy, holidays, housing-market, inflation, interest-rates, labor-market, politics. Omit for every category. A value outside that set is rejected.
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 2000 releases and the earliest are kept, so a window that comes back with exactly 2000 may have more that were not returned. An unfiltered window reaches that inside a couple of months, since every country together runs to tens of releases a day once the low-impact ones are counted. Narrow the date range, the countries or the impact levels to stay under it.
Tokens the request consumed, per content tier. Present only for API keys billed in tokens.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bigdata.com API developer docs","colors":{"primary":"#4CA7F9","light":"#4CA7F9","dark":"#4CA7F9"},"logo":{"light":"https://mintcdn.com/ravenpackinternational/O1z6qnY-XMCwjEFX/logo/bigdata_logo_v3c_dark.svg?fit=max\u0026auto=format\u0026n=O1z6qnY-XMCwjEFX\u0026q=85\u0026s=946489fc058b9cc72700f20c4a07234d","dark":"https://mintcdn.com/ravenpackinternational/O1z6qnY-XMCwjEFX/logo/bigdata_logo_v3c_light.svg?fit=max\u0026auto=format\u0026n=O1z6qnY-XMCwjEFX\u0026q=85\u0026s=e100148ed224aa533563ab5a82c155c6"},"favicon":"https://mintcdn.com/ravenpackinternational/oXZ2k4-F2a4nJaoe/favicon-32x32.png?fit=max\u0026auto=format\u0026n=oXZ2k4-F2a4nJaoe\u0026q=85\u0026s=287ed1df194928ab25af5ed2186e58d0","appearance":{"default":"dark"},"background":{"color":{"dark":"#121212"}},"navbar":{"links":[{"href":"https://app.bigdata.com/signup?utm_source=docs","label":"Sign Up"}],"primary":{"type":"button","label":"Developer Platform","href":"https://platform.bigdata.com/"}},"footer":{"socials":{"x":"https://x.com/bigdatadotcom","linkedin":"https://www.linkedin.com/company/bigdata","instagram":"https://www.instagram.com/bigdatadotcom"}},"seo":{"metatags":{"canonical":"https://docs.bigdata.com"}},"integrations":{"mixpanel":{"projectToken":"0f78753900544f455b1d78b4b5c4aac4"}},"contextual":{"options":["download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ravenpackinternational","hasAudioNarration":false,"actualSubdomain":"ravenpackinternational","customDomains":["docs.bigdata.com"],"gitSource":{"type":"github","owner":"ravenpack","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4e9e80815e4a7eeae9e32","collectionId":"3c3df84a-637e-40e0-9788-86f8824662ed","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4e9e80815e4a7eeae9e32"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4e9e80815e4a7eeae9e32","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API","count":117},{"language":"default","tag":"MCP","count":47},{"language":"default","tag":"Research Service","count":34},{"language":"default","tag":"Structured Data","count":33},{"language":"default","tag":"Getting Started","count":31},{"language":"default","tag":"How to guides","count":31},{"language":"default","tag":"Knowledge Graph","count":30},{"language":"default","tag":"Cookbooks","count":29},{"language":"default","tag":"Tools","count":27},{"language":"default","tag":"Search Service","count":24}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url(./widgets/widgets.css);html{scroll-behavior:smooth}.center-container{display:flex;justify-content:center;align-items:center}.medium_size{height:200px}.hero-bg{background-image:url(https://mintlify.s3.us-west-1.amazonaws.com/ravenpackinternational/images/hero-bg-enhanced.jpg),url(https://mintlify.s3.us-west-1.amazonaws.com/ravenpackinternational/images/hero-bg.jpg);background-size:cover;background-position:center;background-repeat:no-repeat}.hero-bg-content{color:#111!important}.hero-logo{filter:none!important}.text-playground-input{color:#171a1b!important}.dark .text-playground-input{color:#fff!important}.text-playground-input option{color:#171a1b!important;background-color:#fff!important}.dark .text-playground-input option{color:#fff!important;background-color:#171a1b!important}#navbar img.nav-logo{height:24px}@media (max-width:600px){#navbar img.nav-logo{height:20px}}.author-avatar-image{width:100%;height:100%;display:block;object-fit:cover;margin:0}.dark img[src$=\"/images/logos/chatgpt.svg\"],.dark img[src$=\"/images/logos/grok.svg\"]{filter:invert(1)}"},{"filePath":"widgets/widgets.css","content":""}],"page":{"pagePath":"api-reference/company-\u0026-events/economic-calendar","slug":"/api-reference/company-\u0026-events/economic-calendar","pageMetadata":{"title":"Economic Calendar","description":"Returns the macroeconomic releases scheduled in a window: inflation, growth,\nemployment, central bank decisions and the rest of the economic calendar, for the\ncountries requested. Each release carries the figure published, the market consensus\nand the prior period, so a caller can see both what was expected and what landed.\nFigures are returned in full units. There is no pagination, and a response is capped\nat 1000 releases, so narrow the window or the filters to stay under it.","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/economic-calendar/query","href":"/api-reference/company-\u0026-events/economic-calendar","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the macroeconomic releases scheduled in a window: inflation, growth,\\nemployment, central bank decisions and the rest of the economic calendar, for the\\ncountries requested. Each release carries the figure published, the market consensus\\nand the prior period, so a caller can see both what was expected and what landed.\\nFigures are returned in full units. There is no pagination, and a response is capped\\nat 1000 releases, so narrow the window or the filters to stay under it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Economic Calendar","description":"Returns the macroeconomic releases scheduled in a window: inflation, growth,\nemployment, central bank decisions and the rest of the economic calendar, for the\ncountries requested. Each release carries the figure published, the market consensus\nand the prior period, so a caller can see both what was expected and what landed.\nFigures are returned in full units. There is no pagination, and a response is capped\nat 1000 releases, so narrow the window or the filters to stay under it.","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/economic-calendar/query","href":"/api-reference/company-\u0026-events/economic-calendar","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ravenpackinternational/e8fac7367cdeecdc/script.js"],"openApiReferenceData":{"operation":{"tags":["Company \u0026 Events"],"summary":"Economic Calendar","description":"Returns the macroeconomic releases scheduled in a window: inflation, growth,\nemployment, central bank decisions and the rest of the economic calendar, for the\ncountries requested. Each release carries the figure published, the market consensus\nand the prior period, so a caller can see both what was expected and what landed.\nFigures are returned in full units. There is no pagination, and a response is capped\nat 1000 releases, so narrow the window or the filters to stay under it.","operationId":"query_economic_calendar_v1_economic_calendar_query__post","requestBody":"22abcef9-d480-4745-a759-1fc4bcab22a2","responses":{"200":"4ece0275-d2d6-4ecb-b588-3e30601a5ce9","400":"f728d1be-3a2b-4f0c-9289-ebc357ef21fb","429":"62f6de04-363c-4d57-a4d0-1cb02742ec35","500":"484bc4cc-fbcc-4a7a-866b-5a46a050c8db"},"method":"post","type":"path","servers":["1d344a4c-e306-48e9-8963-6a4d795c80e5"],"security":["0e0334aa-fd36-4778-b7e5-581c07190a6c"],"path":"/v1/economic-calendar/query","baseUrlOptions":["https://api.bigdata.com/"],"title":"Economic Calendar","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"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"],"isRequired":true,"uniqueKey":"start_date","typeLabel":"string\u003cdate>"},"end_date":{"type":"string","format":"date","title":"End Date","description":"Last day of the window, as YYYY-MM-DD. Inclusive.","examples":["2026-01-31"],"isRequired":true,"uniqueKey":"end_date","typeLabel":"string\u003cdate>"},"countries":{"oneOf":[{"type":"array","items":{"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","uniqueKey":"countries.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"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.","example":["US","GB","EMU"],"uniqueKey":"countries.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"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.","example":["US","GB","EMU"],"uniqueKey":"countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"countries","typeLabel":"enum\u003cstring>[] | null"},"impacts":{"oneOf":[{"type":"array","items":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH"],"title":"ImpactLevel","description":"How much market movement a release is expected to cause.\n\nThe 'impacts' filter takes these names, and each release answers the one it carries.\nCase does not matter.","uniqueKey":"impacts.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Impacts","description":"Expected market impact levels to return. Omit for every level. Case does not matter.","example":["HIGH","MEDIUM"],"uniqueKey":"impacts.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Impacts","description":"Expected market impact levels to return. Omit for every level. Case does not matter.","example":["HIGH","MEDIUM"],"uniqueKey":"impacts.oneOf.1","typeLabel":"null"}],"uniqueKey":"impacts","typeLabel":"enum\u003cstring>[] | null"},"categories":{"oneOf":[{"type":"array","items":{"type":"string","enum":["bond-auctions","capital-flows","central-banks","consumption","economic-activity","energy","holidays","housing-market","inflation","interest-rates","labor-market","politics"],"title":"EconomicCategory","uniqueKey":"categories.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Categories","description":"Categories to filter by. Valid values: bond-auctions, capital-flows, central-banks, consumption, economic-activity, energy, holidays, housing-market, inflation, interest-rates, labor-market, politics. Omit for every category. A value outside that set is rejected.","example":["inflation","labor-market"],"uniqueKey":"categories.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Categories","description":"Categories to filter by. Valid values: bond-auctions, capital-flows, central-banks, consumption, economic-activity, energy, holidays, housing-market, inflation, interest-rates, labor-market, politics. Omit for every category. A value outside that set is rejected.","example":["inflation","labor-market"],"uniqueKey":"categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"categories","typeLabel":"enum\u003cstring>[] | null"}},"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"},"uniqueKey":"","typeLabel":"EconomicCalendarQuery · object"},"examples":{"Example":{"title":"Example","value":{"categories":["inflation","labor-market"],"countries":["US","GB","EMU"],"end_date":"2026-01-31","impacts":["HIGH","MEDIUM"],"start_date":"2026-01-01"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"4ece0275-d2d6-4ecb-b588-3e30601a5ce9":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"results":{"items":{"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"],"isRequired":true,"uniqueKey":"results.items.[INDEX].event_datetime","typeLabel":"string\u003cdate-time>"},"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"],"isRequired":true,"uniqueKey":"results.items.[INDEX].country","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Name of the economic indicator.","examples":["Nonfarm Payrolls"],"isRequired":true,"uniqueKey":"results.items.[INDEX].name","typeLabel":"string"},"impact":{"oneOf":[{"type":"string","title":"ImpactLevel","description":"Expected market impact: NONE, LOW, MEDIUM or HIGH.","enum":["NONE","LOW","MEDIUM","HIGH"],"example":"HIGH","uniqueKey":"results.items.[INDEX].impact.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Expected market impact: NONE, LOW, MEDIUM or HIGH.","example":"HIGH","uniqueKey":"results.items.[INDEX].impact.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].impact","typeLabel":"enum\u003cstring> | null"},"period_date":{"oneOf":[{"type":"string","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.","format":"date","example":"2026-01-01","uniqueKey":"results.items.[INDEX].period_date.oneOf.0","typeLabel":"string\u003cdate>"},{"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.","example":"2026-01-01","uniqueKey":"results.items.[INDEX].period_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].period_date","typeLabel":"string\u003cdate> | null"},"period_type":{"oneOf":[{"type":"string","title":"PeriodType","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.","enum":["NONE","DAY","MONTH","QUARTER"],"example":"MONTH","uniqueKey":"results.items.[INDEX].period_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"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.","example":"MONTH","uniqueKey":"results.items.[INDEX].period_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].period_type","typeLabel":"enum\u003cstring> | null"},"actual":{"oneOf":[{"type":"number","title":"Actual","description":"The released figure, in full units. Absent until the release happens, which is the usual state for a forward-looking window.","example":250000,"uniqueKey":"results.items.[INDEX].actual.oneOf.0","typeLabel":"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.","example":250000,"uniqueKey":"results.items.[INDEX].actual.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].actual","typeLabel":"number | null"},"consensus":{"oneOf":[{"type":"number","title":"Consensus","description":"Market expectation, in full units.","example":200000,"uniqueKey":"results.items.[INDEX].consensus.oneOf.0","typeLabel":"number"},{"type":"null","title":"Consensus","description":"Market expectation, in full units.","example":200000,"uniqueKey":"results.items.[INDEX].consensus.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].consensus","typeLabel":"number | null"},"previous":{"oneOf":[{"type":"number","title":"Previous","description":"The prior period's figure, in full units.","example":180000,"uniqueKey":"results.items.[INDEX].previous.oneOf.0","typeLabel":"number"},{"type":"null","title":"Previous","description":"The prior period's figure, in full units.","example":180000,"uniqueKey":"results.items.[INDEX].previous.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].previous","typeLabel":"number | null"},"revised":{"oneOf":[{"type":"number","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.","example":185000,"uniqueKey":"results.items.[INDEX].revised.oneOf.0","typeLabel":"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.","example":185000,"uniqueKey":"results.items.[INDEX].revised.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].revised","typeLabel":"number | null"},"ratio_deviation":{"oneOf":[{"type":"number","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.","example":0.25,"uniqueKey":"results.items.[INDEX].ratio_deviation.oneOf.0","typeLabel":"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.","example":0.25,"uniqueKey":"results.items.[INDEX].ratio_deviation.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].ratio_deviation","typeLabel":"number | null"},"surprise":{"oneOf":[{"type":"number","title":"Surprise","description":"How far the released figure fell from the consensus, signed. Read it with 'surprise_unit', which says which of two comparisons produced it: an indicator already published as a percentage is compared by subtraction, in percentage points, and every other indicator relatively, as a percentage of the consensus. Absent when either figure is, and for the relative comparison when the consensus is zero.","example":25,"uniqueKey":"results.items.[INDEX].surprise.oneOf.0","typeLabel":"number"},{"type":"null","title":"Surprise","description":"How far the released figure fell from the consensus, signed. Read it with 'surprise_unit', which says which of two comparisons produced it: an indicator already published as a percentage is compared by subtraction, in percentage points, and every other indicator relatively, as a percentage of the consensus. Absent when either figure is, and for the relative comparison when the consensus is zero.","example":25,"uniqueKey":"results.items.[INDEX].surprise.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].surprise","typeLabel":"number | null"},"surprise_unit":{"oneOf":[{"type":"string","title":"SurpriseUnit","description":"What 'surprise' is measured in: 'pp' for percentage points, on an indicator already published as a percentage such as a CPI rate, and '%' for a percentage of the consensus on every other indicator, such as a payroll count. Absent exactly when 'surprise' is. Two surprises cannot be compared without it: -0.2pp and -6.25% describe the same release.","enum":["%","pp"],"example":"%","uniqueKey":"results.items.[INDEX].surprise_unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"What 'surprise' is measured in: 'pp' for percentage points, on an indicator already published as a percentage such as a CPI rate, and '%' for a percentage of the consensus on every other indicator, such as a payroll count. Absent exactly when 'surprise' is. Two surprises cannot be compared without it: -0.2pp and -6.25% describe the same release.","example":"%","uniqueKey":"results.items.[INDEX].surprise_unit.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].surprise_unit","typeLabel":"enum\u003cstring> | null"},"is_better_than_expected":{"oneOf":[{"type":"boolean","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.","example":true,"uniqueKey":"results.items.[INDEX].is_better_than_expected.oneOf.0","typeLabel":"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.","example":true,"uniqueKey":"results.items.[INDEX].is_better_than_expected.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_better_than_expected","typeLabel":"boolean | null"},"unit":{"oneOf":[{"type":"string","title":"Unit","description":"What the figures are measured in: '%' for a rate, '$' for a monetary value, absent for a count such as jobs.","example":"%","uniqueKey":"results.items.[INDEX].unit.oneOf.0","typeLabel":"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.","example":"%","uniqueKey":"results.items.[INDEX].unit.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].unit","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","title":"EconomicCategory","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.","enum":["bond-auctions","capital-flows","central-banks","consumption","economic-activity","energy","holidays","housing-market","inflation","interest-rates","labor-market","politics"],"example":"labor-market","uniqueKey":"results.items.[INDEX].category.oneOf.0","typeLabel":"enum\u003cstring>"},{"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.","example":"labor-market","uniqueKey":"results.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].category","typeLabel":"enum\u003cstring> | null"},"communication_types":{"items":{"type":"string","enum":["REPORT","SPEECH"],"title":"CommunicationType","description":"A form an entry takes when it is prose rather than a figure.\n\nThe provider flags the two independently and may set both, so a row carries them as\na list rather than choosing between them.","uniqueKey":"results.items.[INDEX].communication_types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"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"]],"uniqueKey":"results.items.[INDEX].communication_types","typeLabel":"enum\u003cstring>[]"},"is_all_day":{"oneOf":[{"type":"boolean","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.","example":false,"uniqueKey":"results.items.[INDEX].is_all_day.oneOf.0","typeLabel":"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.","example":false,"uniqueKey":"results.items.[INDEX].is_all_day.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_all_day","typeLabel":"boolean | null"},"is_tentative":{"oneOf":[{"type":"boolean","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.","example":false,"uniqueKey":"results.items.[INDEX].is_tentative.oneOf.0","typeLabel":"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.","example":false,"uniqueKey":"results.items.[INDEX].is_tentative.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_tentative","typeLabel":"boolean | null"},"actual_is_preliminary":{"oneOf":[{"type":"boolean","title":"Actual Is Preliminary","description":"Whether 'actual' is a first estimate. A preliminary figure is normally restated in a later release.","example":false,"uniqueKey":"results.items.[INDEX].actual_is_preliminary.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Actual Is Preliminary","description":"Whether 'actual' is a first estimate. A preliminary figure is normally restated in a later release.","example":false,"uniqueKey":"results.items.[INDEX].actual_is_preliminary.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].actual_is_preliminary","typeLabel":"boolean | null"},"previous_is_preliminary":{"oneOf":[{"type":"boolean","title":"Previous Is Preliminary","description":"Whether 'previous' is a first estimate rather than a settled figure. This is what a value in 'revised' corrects.","example":false,"uniqueKey":"results.items.[INDEX].previous_is_preliminary.oneOf.0","typeLabel":"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.","example":false,"uniqueKey":"results.items.[INDEX].previous_is_preliminary.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].previous_is_preliminary","typeLabel":"boolean | null"}},"type":"object","required":["event_datetime","country","name"],"title":"EconomicEvent","uniqueKey":"results.items.[INDEX]","typeLabel":"EconomicEvent · object"},"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 2000 releases and the earliest are kept, so a window that comes back with exactly 2000 may have more that were not returned. An unfiltered window reaches that inside a couple of months, since every country together runs to tens of releases a day once the low-impact ones are counted. Narrow the date range, the countries or the impact levels to stay under it.","isRequired":true,"uniqueKey":"results","typeLabel":"EconomicEvent · object[]"},"errors":{"oneOf":[{"type":"array","items":{"properties":{"message":{"oneOf":[{"type":"string","title":"Message","uniqueKey":"errors.oneOf.0.items.[INDEX].message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","uniqueKey":"errors.oneOf.0.items.[INDEX].message.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string | null"}},"type":"object","title":"ErrorDetail","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"ErrorDetail · object"},"title":"Errors","uniqueKey":"errors.oneOf.0","typeLabel":"ErrorDetail · object[]"},{"type":"null","title":"Errors","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"ErrorDetail · object[] | null"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","required":["request_id"],"properties":{"request_id":{"type":"string","title":"Request Id","isRequired":true,"uniqueKey":"metadata.oneOf.0.request_id","typeLabel":"string"},"timestamp":{"type":"string","title":"Timestamp","uniqueKey":"metadata.oneOf.0.timestamp","typeLabel":"string"}},"uniqueKey":"metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"Metadata · object | null"},"sources":{"items":{"properties":{"id":{"type":"string","title":"Id","description":"Content catalog identifier of the source.","examples":["CA9FA3"],"isRequired":true,"uniqueKey":"sources.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Catalog name of the dataset the data came from.","examples":["Corporate Fundamentals"],"isRequired":true,"uniqueKey":"sources.items.[INDEX].name","typeLabel":"string"}},"type":"object","required":["id","name"],"title":"Source","description":"A content catalog source that contributed data to a structured-data response.","uniqueKey":"sources.items.[INDEX]","typeLabel":"Source · object"},"type":"array","title":"Sources","description":"The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed.","uniqueKey":"sources","typeLabel":"Source · object[]"},"usage":{"oneOf":[{"type":"object","title":"Usage","description":"Tokens the request consumed, per content tier. Present only for API keys billed in tokens.","additionalProperties":{"type":"integer","uniqueKey":"usage.oneOf.0.additionalProperties","typeLabel":"integer"},"uniqueKey":"usage.oneOf.0","typeLabel":"Usage · object"},{"type":"null","description":"Tokens the request consumed, per content tier. Present only for API keys billed in tokens.","uniqueKey":"usage.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage","typeLabel":"Usage · object | 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,"surprise_unit":"%"}]},"uniqueKey":"","typeLabel":"EconomicCalendarResponse · object"},"examples":{"Example":{"title":"Example","value":{"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,"surprise_unit":"%"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"f728d1be-3a2b-4f0c-9289-ebc357ef21fb":{"description":"Bad Request","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","const":400,"title":"Statuscode","default":400,"uniqueKey":"statusCode","typeLabel":"integer"}},"type":"object","required":["message"],"title":"BadRequestError","description":"Bad Request Error","example":{"message":"Bad Request Error","statusCode":400},"uniqueKey":"","typeLabel":"BadRequestError · object"},"examples":{"Example":{"title":"Example","value":{"message":"Bad Request Error","statusCode":400}}},"exampleType":"generated"}},"exampleType":"generated"},"62f6de04-363c-4d57-a4d0-1cb02742ec35":{"description":"Too Many Requests","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","const":429,"title":"Statuscode","default":429,"uniqueKey":"statusCode","typeLabel":"integer"}},"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},"uniqueKey":"","typeLabel":"TooManyRequestsError · object"},"examples":{"Example":{"title":"Example","value":{"message":"Too many requests. Please try again later.","statusCode":429}}},"exampleType":"generated"}},"exampleType":"generated"},"484bc4cc-fbcc-4a7a-866b-5a46a050c8db":{"description":"Internal Server Error","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"integer","const":500,"title":"Statuscode","default":500,"uniqueKey":"statusCode","typeLabel":"integer"}},"type":"object","required":["message"],"title":"InternalServerError","description":"Internal Server Error","example":{"message":"Internal Server Error","statusCode":500},"uniqueKey":"","typeLabel":"InternalServerError · object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal Server Error","statusCode":500}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0e0334aa-fd36-4778-b7e5-581c07190a6c":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"1d344a4c-e306-48e9-8963-6a4d795c80e5":{"url":"https://api.bigdata.com/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-rest/openapi/openapi_structured_data.json"},"subdomain":"ravenpackinternational","siteName":"Bigdata.com API developer docs","title":"Economic Calendar - Bigdata.com API developer docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T16:29:23.677Z","originalFileLocation":"api-reference/company-\u0026-events/economic-calendar.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bigdata.com API developer docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Economic Calendar - Bigdata.com API developer docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bigdata.com API developer docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bigdata.com/api-reference/company-\u0026amp;-events/economic-calendar\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ravenpackinternational.mintlify.app/_mintlify/api/og/v2?division=Company+%26+Events\u0026amp;title=Economic+Calendar\u0026amp;description=Returns+the+macroeconomic+releases+scheduled+in+a+window%3A+inflation%2C+growth%2C%0Aemployment%2C+central+bank+decisions+and+the+rest+of+the+economic+calendar%2C+for+the%0Ac\u0026amp;theme=0bfd5283ab20b98a8d106eeb\u0026amp;signature=c2102bb2205a3f703affb4039700430669745e0c971147340af53cbbdab4eee0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Economic Calendar - Bigdata.com API developer docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ravenpackinternational.mintlify.app/_mintlify/api/og/v2?division=Company+%26+Events\u0026amp;title=Economic+Calendar\u0026amp;description=Returns+the+macroeconomic+releases+scheduled+in+a+window%3A+inflation%2C+growth%2C%0Aemployment%2C+central+bank+decisions+and+the+rest+of+the+economic+calendar%2C+for+the%0Ac\u0026amp;theme=0bfd5283ab20b98a8d106eeb\u0026amp;signature=c2102bb2205a3f703affb4039700430669745e0c971147340af53cbbdab4eee0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ravenpackinternational/0ZQJThiL-hYHaY_C/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bigdata.com API developer docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4CA7F9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bigdata.com/api-reference/company-\u0026amp;-events/economic-calendar\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/company-%26-events/economic-calendar.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bigdata.com/#organization\",\"name\":\"Bigdata.com API developer docs\",\"url\":\"https://docs.bigdata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ravenpackinternational/O1z6qnY-XMCwjEFX/logo/bigdata_logo_v3c_dark.svg?fit=max\u0026auto=format\u0026n=O1z6qnY-XMCwjEFX\u0026q=85\u0026s=946489fc058b9cc72700f20c4a07234d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bigdata.com#website\",\"name\":\"Bigdata.com API developer docs\",\"url\":\"https://docs.bigdata.com\",\"publisher\":{\"@id\":\"https://docs.bigdata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar#webpage\",\"url\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar\",\"name\":\"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.\",\"dateModified\":\"2026-10-29T16:29:23.677Z\",\"isPartOf\":{\"@id\":\"https://docs.bigdata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Structured Data\",\"item\":\"https://docs.bigdata.com/structured-data/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Company \u0026 Events\",\"item\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/company-profile\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Economic Calendar\",\"item\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar#apireference\",\"headline\":\"Economic Calendar\",\"name\":\"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.\",\"url\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bigdata.com/api-reference/company-\u0026-events/economic-calendar#webpage\"},\"dateModified\":\"2026-10-29T16:29:23.677Z\",\"publisher\":{\"@id\":\"https://docs.bigdata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bigdata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bigdata.com API developer docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bigdata.com API developer docs","nav":{"global":null,"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":""}]},{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/getting-started/introduction"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq/privacy_questions"}]},{"tab":"How to guides","pages":[{"title":"How to guides","href":"/how-to-guides/introduction"}]},{"tab":"Cookbooks","pages":[{"title":"Cookbooks","href":"/use-cases/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk-reference/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp-reference/introduction"}]},{"tab":"Skills","pages":[{"title":"Skills","href":"/skills-reference/introduction"}]},{"tab":"API","pages":[{"group":"API","pages":[{"title":"Introduction to Bigdata APIs","sidebarTitle":"Introduction","href":"/api-rest/introduction"},{"title":"Domains to whitelist","href":"/api-rest/bigdata_domains"},{"title":"Authentication","href":"/api-rest/authentication"},{"group":"Best practices","pages":[{"title":"Resolve companies","href":"/api-rest/best-practices/resolve_companies"},{"title":"Company news coverage","sidebarTitle":"News Coverage","href":"/api-rest/best-practices/company_news_coverage"}]},{"title":"Rate limits","href":"/api-rest/rate_limits"},{"title":"Bigdata CLI","sidebarTitle":"Bigdata CLI","href":"/cli-reference/introduction"}]},{"group":"Knowledge Graph","pages":[{"group":"Companies","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/companies","href":"/api-reference/companies/find-by-details"},{"title":"Get by ISIN","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/companies/isin","href":"/api-reference/companies/get-by-isin"},{"title":"Get by CUSIP","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/companies/cusip","href":"/api-reference/companies/get-by-cusip"},{"title":"Get by SEDOL","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/companies/sedol","href":"/api-reference/companies/get-by-sedol"},{"title":"Get by Listing","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/companies/listing","href":"/api-reference/companies/get-by-listing"},{"title":"Get sectors","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json get /v1/knowledge-graph/companies/sectors","href":"/api-reference/companies/get-sectors"},{"title":"Get Subsidiaries","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/subsidiaries/query","href":"/api-reference/companies/get-subsidiaries"}]},{"group":"ETFs","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/etfs","href":"/api-reference/etfs/find-by-details"}]},{"group":"Sources","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/sources","href":"/api-reference/sources/find-by-details"}]},{"group":"Organizations","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/organizations","href":"/api-reference/organizations/find-by-details"}]},{"group":"People","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/people","href":"/api-reference/people/find-by-details"}]},{"group":"Places","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/places","href":"/api-reference/places/find-by-details"}]},{"group":"Products","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/products","href":"/api-reference/products/find-by-details"}]},{"group":"Concepts","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/concepts","href":"/api-reference/concepts/find-by-details"}]},{"group":"Topics","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/topics","href":"/api-reference/topics/find-by-details"}]},{"group":"Funds","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/funds","href":"/api-reference/funds/find-by-details"}]},{"group":"Positions","pages":[{"title":"Find by details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/positions","href":"/api-reference/positions/find-by-details"}]},{"group":"Filter values","pages":[{"title":"Get filter values","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json get /v1/knowledge-graph/{category}/values/{filter}","href":"/api-reference/filter-values/get-filter-values"}]},{"group":"Entities","pages":[{"title":"Get Entities by ID","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/entities/id","href":"/api-reference/entities/get-entities-by-id"}]}]},{"group":"Search Service","pages":[{"group":"Search","pages":[{"title":"Search documents","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search","href":"/api-reference/search/search-documents"},{"title":"Search volume","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search/volume","href":"/api-reference/search/search-volume"},{"title":"Search watchlist","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search/watchlist","href":"/api-reference/search/search-watchlist"},{"title":"Fetch document","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json get /v1/documents/{document_id}","href":"/api-reference/search/fetch-document"}]},{"group":"Batch Search","pages":[{"title":"Create a Batch Job","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search/batches","href":"/api-reference/batch-search/create-a-batch-job"},{"title":"Upload Your Input File","deprecated":null,"version":null,"playground":"none","openapi":"/api-rest/openapi/openapi_search_service.json put /s3_upload_placeholder","href":"/api-reference/batch-search/upload-your-input-file"},{"title":"Get Batch Job Info","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json get /v1/search/batches/{batch_id}","href":"/api-reference/batch-search/get-batch-job-info"}]},{"group":"Co-mentions","pages":[{"title":"Connected Entities","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search/co-mentions/entities","href":"/api-reference/co-mentions/connected-entities"},{"title":"Connected Topics","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_service.json post /v1/search/co-mentions/topics","href":"/api-reference/co-mentions/connected-topics"}]}]},{"group":"Monitors","tag":"Coming soon","pages":[{"group":"Manage","pages":[{"title":"Create a monitor","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json post /v1/search-monitoring/monitors","href":"/api-reference/monitors/create-a-monitor"},{"title":"List monitors","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json get /v1/search-monitoring/monitors","href":"/api-reference/monitors/list-monitors"},{"title":"Get monitor details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json get /v1/search-monitoring/monitors/{monitor_id}","href":"/api-reference/monitors/get-monitor-details"},{"title":"Update a monitor","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json patch /v1/search-monitoring/monitors/{monitor_id}","href":"/api-reference/monitors/update-a-monitor"},{"title":"Delete a monitor","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json delete /v1/search-monitoring/monitors/{monitor_id}","href":"/api-reference/monitors/delete-a-monitor"}]},{"group":"Test","pages":[{"title":"Simulate a monitor","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json post /v1/search-monitoring/monitors/{monitor_id}/simulate","href":"/api-reference/monitors/simulate-a-monitor"}]},{"group":"Runs","pages":[{"title":"List monitor runs","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json get /v1/search-monitoring/monitors/{monitor_id}/runs","href":"/api-reference/monitors/list-monitor-runs"},{"title":"Get run details","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_search_monitoring.json get /v1/search-monitoring/monitors/{monitor_id}/runs/{run_id}","href":"/api-reference/monitors/get-run-details"}]}]},{"group":"Research Service","pages":[{"title":"Workflows API","sidebarTitle":"Introduction","href":"/api-rest/workflows/introduction"},{"group":"Research Agent","pages":[{"title":"Research Agent","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_research_agent.json post /v1/research-agent","href":"/api-reference/research-agent/research-agent"}]},{"group":"Workflows","pages":[{"title":"Execute Workflow","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json post /v1/workflow/execute","href":"/api-reference/workflows/execute-workflow"},{"title":"Submit Workflow","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json post /v1/workflow/execute/async","href":"/api-reference/workflows/submit-workflow"},{"title":"Stream Workflow Events","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/execute/async/{execution_id}/stream","href":"/api-reference/workflows/stream-workflow-events"},{"title":"Cancel Workflow","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json post /v1/workflow/execute/async/{execution_id}/cancel","href":"/api-reference/workflows/cancel-workflow"},{"title":"List Executions","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/executions","href":"/api-reference/workflow-executions/list-executions"},{"title":"Get Execution","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/executions/{execution_id}","href":"/api-reference/workflow-executions/get-execution"},{"title":"Delete Execution","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json delete /v1/workflow/executions/{execution_id}","href":"/api-reference/workflow-executions/delete-execution"},{"title":"List Templates","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/templates","href":"/api-reference/workflow-templates/list-templates"},{"title":"Create Template","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json post /v1/workflow/templates","href":"/api-reference/workflow-templates/create-template"},{"title":"Get Template","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/templates/{template_id}","href":"/api-reference/workflow-templates/get-template"},{"title":"Update Template","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json put /v1/workflow/templates/{template_id}","href":"/api-reference/workflow-templates/update-template"},{"title":"Delete Template","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json delete /v1/workflow/templates/{template_id}","href":"/api-reference/workflow-templates/delete-template"},{"title":"List Community Templates","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json get /v1/workflow/templates/community","href":"/api-reference/workflow-templates/list-community-templates"},{"title":"Clone Template","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_workflows.json post /v1/workflow/templates/{template_id}/clone","href":"/api-reference/workflow-templates/clone-template"}]}]},{"group":"Content","pages":[{"title":"Introduction","href":"/api-rest/content_introduction"},{"group":"Connectors","pages":[{"title":"Create connector","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json post /contents/v1/connectors","href":"/api-reference/connectors/create-connector"},{"title":"List connectors","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/connectors","href":"/api-reference/connectors/list-connectors"},{"title":"Get connector by ID","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/connectors/{connector_id}","href":"/api-reference/connectors/get-connector-by-id"},{"title":"Update connector by ID","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json put /contents/v1/connectors/{connector_id}","href":"/api-reference/connectors/update-connector-by-id"},{"title":"Trigger connector sync","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json post /contents/v1/connectors/{connector_id}/sync","href":"/api-reference/connectors/trigger-connector-sync"},{"title":"Delete connector by ID","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json delete /contents/v1/connectors/{connector_id}","href":"/api-reference/connectors/delete-connector-by-id"}]},{"group":"Documents","pages":[{"title":"Enrich document","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json post /contents/v1/documents","href":"/api-reference/documents/enrich-document"},{"title":"List documents","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/documents","href":"/api-reference/documents/list-documents"},{"title":"Get document metadata","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/documents/{content_id}","href":"/api-reference/documents/get-document-metadata"},{"title":"Update document metadata","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json patch /contents/v1/documents/{content_id}","href":"/api-reference/documents/update-document-metadata"},{"title":"Get annotated document","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/documents/{content_id}/annotated","href":"/api-reference/documents/get-annotated-document"},{"title":"Get original document","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/documents/{content_id}/original","href":"/api-reference/documents/get-original-document"},{"title":"Delete document","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json delete /contents/v1/documents/{content_id}","href":"/api-reference/documents/delete-document"}]},{"group":"Tags","pages":[{"title":"List tags","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json get /contents/v1/tags","href":"/api-reference/tags/list-tags"},{"title":"Create tag","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json post /contents/v1/tags","href":"/api-reference/tags/create-tag"},{"title":"Delete tag","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_content_data.json delete /contents/v1/tags/{tag_id}","href":"/api-reference/tags/delete-tag"}]}]},{"group":"Structured Data","pages":[{"title":"Introduction","href":"/structured-data/introduction"},{"group":"Market Data","pages":[{"title":"Daily Prices","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/price/daily/query","href":"/api-reference/market-data/daily-prices"},{"title":"Intraday Prices","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/price/intraday/query","href":"/api-reference/market-data/intraday-prices"},{"title":"Aftermarket Prices","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/price/aftermarket/query","href":"/api-reference/market-data/aftermarket-prices"},{"title":"Dividends","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/dividends/query","href":"/api-reference/market-data/dividends"},{"title":"Price Changes","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/price/changes/query","href":"/api-reference/market-data/price-changes"},{"title":"Quote","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/quote/query","href":"/api-reference/market-data/quote"},{"title":"Entity Sentiment","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/entity-sentiment/","href":"/api-reference/market-data/entity-sentiment"}]},{"group":"Analyst Estimates","pages":[{"title":"Analyst Estimates","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/analyst-estimates/query","href":"/api-reference/analyst-estimates/analyst-estimates"},{"title":"Analyst Ratings","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/analyst-ratings/query","href":"/api-reference/analyst-estimates/analyst-ratings"},{"title":"Earnings Surprises","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/latest-surprise/query","href":"/api-reference/analyst-estimates/earnings-surprises"},{"title":"Target Price","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/price/target/query","href":"/api-reference/analyst-estimates/target-price"}]},{"group":"Financials \u0026 Ratios","pages":[{"title":"Balance Sheet","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/balance-sheet/query","href":"/api-reference/financials-\u0026-ratios/balance-sheet"},{"title":"Cash Flow Statement","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/cash-flow-statement/query","href":"/api-reference/financials-\u0026-ratios/cash-flow-statement"},{"title":"Company Ratios TTM","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/company-ratios-ttm/query","href":"/api-reference/financials-\u0026-ratios/company-ratios-ttm"},{"title":"Income Statement","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/income-statement/query","href":"/api-reference/financials-\u0026-ratios/income-statement"},{"title":"Key Metrics TTM","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/key-metrics-ttm/query","href":"/api-reference/financials-\u0026-ratios/key-metrics-ttm"},{"title":"Revenue Geographic Segments","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/company-revenue-geographic-segments/query","href":"/api-reference/financials-\u0026-ratios/revenue-geographic-segments"},{"title":"Revenue Product Segments","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/company-revenue-product-segments/query","href":"/api-reference/financials-\u0026-ratios/revenue-product-segments"}]},{"group":"Company \u0026 Events","pages":[{"title":"Company Profile","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/company-profile/query","href":"/api-reference/company-\u0026-events/company-profile"},{"title":"Stocks \u0026 Funds Screener","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/company-screener/query","href":"/api-reference/company-\u0026-events/stocks-\u0026-funds-screener"},{"title":"Events Calendar","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/events-calendar/query","href":"/api-reference/company-\u0026-events/events-calendar"},{"title":"ESG Scores","description":"The ESG Performance Score API provides a comprehensive evaluation of a company's environmental, social, and governance (ESG) practices. It aggregates various ESG metrics into a single performance score, allowing investors and stakeholders to assess the company's commitment to sustainable and responsible business operations.\n\nThe ESG scores reflect companies' sustainability performance relative to financially material ESG issues. Scores are derived from standardized company-reported data and peer-based relative scoring techniques, resulting in a 0–100 scale that indicates a company's position versus its global peers, following a sector-specific, SASB (Sustainability Accounting Standards Board)-inspired materiality framework.\n\n| Performance | Score Range |\n|---|---|\n| Laggard | \u003c 42 |\n| Below Average | 42 - 47 |\n| Average | 48 - 53 |\n| Above Average | 54 - 59 |\n| Leader | ≥ 60 |","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/esg-performance-score/query","href":"/api-reference/company-\u0026-events/esg-scores"},{"title":"Economic Calendar","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/economic-calendar/query","href":"/api-reference/company-\u0026-events/economic-calendar"}]},{"group":"Fund Holdings","pages":[{"title":"Fund Holdings","description":"Retrieve portfolio holdings disclosed by institutional funds in their SEC 13F filings. This dataset provides an overview of a fund’s positions, including the total number of holdings, overall portfolio size, and high-level summaries such as top holdings and allocation trends. It also allows retrieval of the top buys and sells for a fund or fund manager, either for the latest portfolio or for historical quarters. Sector composition of the fund’s portfolio can also be accessed.","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/holdings/funds/stocks/","href":"/api-reference/fund-holdings/fund-holdings"},{"title":"Stock Fund Holdings","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/holdings/stocks/funds","href":"/api-reference/fund-holdings/stock-fund-holdings"},{"title":"Fund Position Signals","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/holdings/funds/trends/","href":"/api-reference/fund-holdings/fund-position-signals"}]},{"group":"Private Markets","pages":[{"title":"Private Company Overview","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/private-companies/query","href":"/api-reference/private-markets/private-company-overview"},{"title":"Private Company Funding Rounds","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/funding-rounds/query","href":"/api-reference/private-markets/private-company-funding-rounds"},{"title":"Private Company People","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/private-company-people/query","href":"/api-reference/private-markets/private-company-people"}]},{"group":"Fixed Income","pages":[{"title":"Bonds by Issuer","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/fixed-income/corporate/issuer/query","href":"/api-reference/fixed-income/bonds-by-issuer"},{"title":"Bonds by ISIN","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/fixed-income/corporate/isin/query","href":"/api-reference/fixed-income/bonds-by-isin"},{"title":"Bond prices","deprecated":null,"version":null,"tag":"Beta","openapi":"/api-rest/openapi/openapi_structured_data.json post /v1/fixed-income/corporate/prices/query","href":"/api-reference/fixed-income/bond-prices"}]}]},{"group":"Subscription","pages":[{"group":"Quotas","pages":[{"title":"Get Subscription Quotas","deprecated":null,"version":null,"openapi":"/api-rest/openapi/openapi_subscription.json get /v1/subscription/quotas","href":"/api-reference/quotas/get-subscription-quotas"}]}]}],"global":{"anchors":[{"anchor":"Developer Platform","icon":"code","href":"https://platform.bigdata.com/"},{"anchor":"Bigdata Assistant","icon":"comments-dollar","href":"https://bigdata.com"},{"anchor":"Support","icon":"headset","href":"https://docs.bigdata.com/support"}]}},{"tab":"Widgets","pages":[{"title":"Widgets","href":"/widgets/introduction"}]},{"tab":"Assistant","pages":[{"title":"Assistant","href":"/app/introduction"}]},{"tab":"Content Partners","pages":[{"title":"Content Partners","href":"/partner-content-upload/introduction"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/api_changelog"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support"}]},{"tab":"Blog","pages":[{"title":"Blog","href":"/blog/introduction"}]}]},"basePath":"","title":"Economic Calendar - Bigdata.com API developer docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}