{
"success": false,
"statusCode": 403,
"error": {
"code": "FEATURE_NOT_IN_PLAN",
"message": "Your plan does not include this feature"
},
"meta": {
"timestamp": "2026-06-19T08:34:08.100Z"
}
}
{
"success": false,
"statusCode": 403,
"error": {
"code": "FEATURE_NOT_IN_PLAN",
"message": "Your plan does not include this feature"
},
"meta": {
"timestamp": "2026-06-19T08:34:08.100Z"
}
}
Your HayInsights API key (prefixed apk_). Create and manage keys in the
HayInsights dashboard (Account → API keys).
Send it in the X-API-Key header on every request to /openapi/v1/*.
Which data domains you may access and your request quota are both governed by
the subscription plan attached to the key — see the Plans & features and
Rate limits guides.
Query Parameters
type
enum<string>
required
Macroeconomic indicator to return.
Value
Description
gdp
Gross Domestic Product
cpi
Consumer Price Index
pce
Personal Consumption Expenditures
import-export
Import & export trade
Available options:
gdp,
cpi,
pce,
import-export
Example:
"gdp"
country
string
default:JP
ISO country code.
Example:
"JP"
period
enum<string>
default:10Y
Look-back window.
Available options:
1Y,
3Y,
10Y
Response
Selected economic data series.
Standard success envelope shared by every endpoint. Each operation's response
wrapper extends this (via allOf) and adds a typed data property.
Array of observations whose item shape depends on the type query
parameter:
gdp → EconomicDataPoint
cpi → MacroCpiData
pce → MacroPceData
import-export → MacroImportExportData
One observation in an economic data series (GDP / CPI / PCE / import-export).
Shared by the GDP growth-rate and economic-data endpoints.
Option 1
MacroCpiData
MacroPceData
MacroImportExportData
Show child attributes
meta
object
Response metadata. Always present; timestamp is the server time the response was generated.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"HayInsights Open API","description":"The official API for the HayInsights financial-data hub — commodities, crypto, ETF, FX, macro, real-estate, news, calendar and market-index datasets.","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/hayinsights/w7ouUmWFSMYI1Ars/logo.svg?fit=max\u0026auto=format\u0026n=w7ouUmWFSMYI1Ars\u0026q=85\u0026s=c48347f2c9a762ef8ee28dfce9259983","dark":"https://mintcdn.com/hayinsights/w7ouUmWFSMYI1Ars/logo-dark.svg?fit=max\u0026auto=format\u0026n=w7ouUmWFSMYI1Ars\u0026q=85\u0026s=323c27a9805bae61409dfcefcb47f5ff"},"favicon":"https://mintcdn.com/hayinsights/w7ouUmWFSMYI1Ars/favicon.svg?fit=max\u0026auto=format\u0026n=w7ouUmWFSMYI1Ars\u0026q=85\u0026s=d307dee7c605bf90e7b21fdd1a05c839","navbar":{"links":[{"href":"https://app.hayinsights.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get API key","href":"https://app.hayinsights.com/en/api-keys"}},"footer":{"socials":{"website":"https://hayinsights.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hayinsights","hasAudioNarration":false,"actualSubdomain":"hayinsights","customDomains":["developer.hayinsights.com"],"gitSource":{"type":"github","owner":"quantran55","repo":"open-api-docs","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af2e2c70e86f2e3048db0ba","clientVersion":"0.0.4138","searchFilterCounts":[{"language":"default","tag":"API Reference","count":90},{"language":"default","tag":"Macro","count":43},{"language":"default","tag":"ETF","count":14},{"language":"default","tag":"Equities","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Real Estate","count":6},{"language":"default","tag":"Commodities","count":5},{"language":"default","tag":"Crypto","count":5},{"language":"default","tag":"FX","count":4},{"language":"default","tag":"Getting started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/macro/economic-data-series","slug":"/api-reference/macro/economic-data-series","pageMetadata":{"title":"Economic data series","description":"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or\nimport-export — for a country, over a chosen look-back window.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/economic-data","href":"/api-reference/macro/economic-data-series","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: \"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or\\nimport-export — for a country, over a chosen look-back window.\"\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 data series","description":"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or\nimport-export — for a country, over a chosen look-back window.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/economic-data","href":"/api-reference/macro/economic-data-series","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"macroEconomicData","tags":["Macro"],"summary":"Economic data series","description":"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or\nimport-export — for a country, over a chosen look-back window.\n","x-feature-code":"macro_data","x-api-weight":2,"parameters":["b45af8df-9ade-4191-9087-400e88f834cb","919f517d-e3e6-4688-9e59-58f919f943b6","5c080400-b46d-4356-97ed-e1e6f339828c"],"responses":{"200":"8ce0eb1d-a067-4cc6-b3aa-fba0cd44d152","400":"9b0a5490-4f76-4ad9-9c16-ea8defef6b0d","401":"d6b93fba-a28d-48e3-a8ac-91e41c905bb4","403":"03c7b259-6676-448d-bd68-4b77c2d4d7c6","429":"f1f6ed71-725f-4a2c-9df7-9a3fc9ac68d9","500":"2000435f-07c4-4783-ab8f-3b177e23d962"},"method":"get","type":"path","servers":["0e8d70bb-52bf-423d-b93d-77da6181da2c"],"security":["9f0354d0-9806-491e-8a42-41ff5e624403"],"path":"/openapi/v1/macro/economic-data","baseUrlOptions":["https://api-v2.hayinsights.com"],"title":"Economic data series","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b45af8df-9ade-4191-9087-400e88f834cb":{"name":"type","in":"query","required":true,"description":"Macroeconomic indicator to return.\n\n| Value | Description |\n| --- | --- |\n| `gdp` | Gross Domestic Product |\n| `cpi` | Consumer Price Index |\n| `pce` | Personal Consumption Expenditures |\n| `import-export` | Import \u0026 export trade |\n","schema":{"type":"string","enum":["gdp","cpi","pce","import-export"],"example":"gdp","isRequired":true,"description":"Macroeconomic indicator to return.\n\n| Value | Description |\n| --- | --- |\n| `gdp` | Gross Domestic Product |\n| `cpi` | Consumer Price Index |\n| `pce` | Personal Consumption Expenditures |\n| `import-export` | Import \u0026 export trade |\n","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"919f517d-e3e6-4688-9e59-58f919f943b6":{"name":"country","in":"query","required":false,"description":"ISO country code.","schema":{"type":"string","default":"JP","example":"JP","isRequired":false,"description":"ISO country code.","uniqueKey":"","typeLabel":"string"}},"5c080400-b46d-4356-97ed-e1e6f339828c":{"name":"period","in":"query","required":false,"description":"Look-back window.","schema":{"type":"string","enum":["1Y","3Y","10Y"],"default":"10Y","isRequired":false,"description":"Look-back window.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"8ce0eb1d-a067-4cc6-b3aa-fba0cd44d152":{"description":"Selected economic data series.","content":{"application/json":{"schema":{"type":"object","description":"Standard success envelope shared by every endpoint. Each operation's response\nwrapper extends this (via `allOf`) and adds a typed `data` property.\n","required":["data","success","statusCode"],"properties":{"success":{"type":"boolean","const":true,"description":"Always `true` for a successful response.","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":200,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"data":{"type":"array","description":"Array of observations whose item shape depends on the `type` query\nparameter:\n\n- `gdp` → `EconomicDataPoint`\n- `cpi` → `MacroCpiData`\n- `pce` → `MacroPceData`\n- `import-export` → `MacroImportExportData`\n","items":{"oneOf":[{"type":"object","description":"One observation in an economic data series (GDP / CPI / PCE / import-export).\nShared by the GDP growth-rate and economic-data endpoints.\n","required":["country","quarter","gdp","gdpUnit","growthRate","dateFrom","dateTo"],"properties":{"country":{"type":"string","description":"ISO country code the series belongs to.","example":"JP","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.country","typeLabel":"string"},"quarter":{"type":"string","description":"Human-readable observation period.","example":"Q1 2026","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.quarter","typeLabel":"string"},"gdp":{"type":"string","description":"Nominal value for the period. Delivered as a string on the wire to\npreserve full numeric precision.\n","example":"677233.400","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.gdp","typeLabel":"string"},"gdpUnit":{"oneOf":[{"type":"string","description":"Unit the value is expressed in.","example":"Billion JPY","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.gdpUnit.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unit the value is expressed in.","example":"Billion JPY","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.gdpUnit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.gdpUnit","typeLabel":"string | null"},"growthRate":{"oneOf":[{"type":"number","description":"Period-over-period nominal growth rate, in percent.","example":0.8,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.growthRate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Period-over-period nominal growth rate, in percent.","example":0.8,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.growthRate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.growthRate","typeLabel":"number | null"},"dateFrom":{"type":"string","format":"date-time","description":"Inclusive start of the observation period.","example":"2026-01-01T00:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.dateFrom","typeLabel":"string\u003cdate-time>"},"dateTo":{"type":"string","format":"date-time","description":"Inclusive end of the observation period.","example":"2026-03-31T23:59:59.999Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.0.dateTo","typeLabel":"string\u003cdate-time>"},"realGdp":{"oneOf":[{"type":"number","description":"Inflation-adjusted value; `null` when not published for the period.","example":null,"uniqueKey":"data.items.[INDEX].oneOf.0.realGdp.oneOf.0","typeLabel":"number"},{"type":"null","description":"Inflation-adjusted value; `null` when not published for the period.","example":null,"uniqueKey":"data.items.[INDEX].oneOf.0.realGdp.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].oneOf.0.realGdp","typeLabel":"number | null"},"realGrowthRate":{"oneOf":[{"type":"number","description":"Inflation-adjusted growth rate, in percent; `null` when unavailable.","example":null,"uniqueKey":"data.items.[INDEX].oneOf.0.realGrowthRate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Inflation-adjusted growth rate, in percent; `null` when unavailable.","example":null,"uniqueKey":"data.items.[INDEX].oneOf.0.realGrowthRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].oneOf.0.realGrowthRate","typeLabel":"number | null"}},"uniqueKey":"data.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","title":"MacroCpiData","description":"One CPI (Consumer Price Index) observation. Returned as an item of the\neconomic-data `data` array when the `type` query parameter is `cpi`.\n","required":["id","createdAt","updatedAt","country","observationDate","cpiPoints","coreCpiPoints","cpiChangeYoyPercent","coreCpiChangeYoyPercent"],"properties":{"id":{"type":"integer","description":"Unique identifier of the observation record.","example":1024,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.id","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"When the record was created.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the record was last updated.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.updatedAt","typeLabel":"string\u003cdate-time>"},"country":{"type":"string","description":"ISO country code the observation belongs to.","example":"JP","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.country","typeLabel":"string"},"observationDate":{"type":"string","format":"date","description":"Date of the observation.","example":"2026-03-01","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.observationDate","typeLabel":"string\u003cdate>"},"cpiPoints":{"oneOf":[{"type":"number","description":"Headline CPI index points; `null` when not published for the period.","example":111.2,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiPoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Headline CPI index points; `null` when not published for the period.","example":111.2,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiPoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiPoints","typeLabel":"number | null"},"coreCpiPoints":{"oneOf":[{"type":"number","description":"Core CPI (excluding food \u0026 energy) index points; `null` when unavailable.","example":109.8,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiPoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Core CPI (excluding food \u0026 energy) index points; `null` when unavailable.","example":109.8,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiPoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiPoints","typeLabel":"number | null"},"cpiChangeYoyPercent":{"oneOf":[{"type":"number","description":"Year-over-year change in headline CPI, in percent; `null` when unavailable.","example":2.7,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiChangeYoyPercent.oneOf.0","typeLabel":"number"},{"type":"null","description":"Year-over-year change in headline CPI, in percent; `null` when unavailable.","example":2.7,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiChangeYoyPercent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.cpiChangeYoyPercent","typeLabel":"number | null"},"coreCpiChangeYoyPercent":{"oneOf":[{"type":"number","description":"Year-over-year change in core CPI, in percent; `null` when unavailable.","example":2.3,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiChangeYoyPercent.oneOf.0","typeLabel":"number"},{"type":"null","description":"Year-over-year change in core CPI, in percent; `null` when unavailable.","example":2.3,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiChangeYoyPercent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.1.coreCpiChangeYoyPercent","typeLabel":"number | null"}},"uniqueKey":"data.items.[INDEX].oneOf.1","typeLabel":"MacroCpiData · object"},{"type":"object","title":"MacroPceData","description":"One PCE (Personal Consumption Expenditures) observation. Returned as an item\nof the economic-data `data` array when the `type` query parameter is `pce`.\n","required":["id","createdAt","updatedAt","country","observationDate","pcePoints","corePcePoints","pceChangeYoyPercent","corePceChangeYoyPercent"],"properties":{"id":{"type":"integer","description":"Unique identifier of the observation record.","example":2048,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.id","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"When the record was created.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the record was last updated.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.updatedAt","typeLabel":"string\u003cdate-time>"},"country":{"type":"string","description":"ISO country code the observation belongs to.","example":"US","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.country","typeLabel":"string"},"observationDate":{"type":"string","format":"date","description":"Date of the observation.","example":"2026-03-01","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.observationDate","typeLabel":"string\u003cdate>"},"pcePoints":{"oneOf":[{"type":"number","description":"Headline PCE index points; `null` when not published for the period.","example":124.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pcePoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Headline PCE index points; `null` when not published for the period.","example":124.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pcePoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pcePoints","typeLabel":"number | null"},"corePcePoints":{"oneOf":[{"type":"number","description":"Core PCE (excluding food \u0026 energy) index points; `null` when unavailable.","example":122.1,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePcePoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Core PCE (excluding food \u0026 energy) index points; `null` when unavailable.","example":122.1,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePcePoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePcePoints","typeLabel":"number | null"},"pceChangeYoyPercent":{"oneOf":[{"type":"number","description":"Year-over-year change in headline PCE, in percent; `null` when unavailable.","example":2.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pceChangeYoyPercent.oneOf.0","typeLabel":"number"},{"type":"null","description":"Year-over-year change in headline PCE, in percent; `null` when unavailable.","example":2.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pceChangeYoyPercent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.pceChangeYoyPercent","typeLabel":"number | null"},"corePceChangeYoyPercent":{"oneOf":[{"type":"number","description":"Year-over-year change in core PCE, in percent; `null` when unavailable.","example":2.2,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePceChangeYoyPercent.oneOf.0","typeLabel":"number"},{"type":"null","description":"Year-over-year change in core PCE, in percent; `null` when unavailable.","example":2.2,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePceChangeYoyPercent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.2.corePceChangeYoyPercent","typeLabel":"number | null"}},"uniqueKey":"data.items.[INDEX].oneOf.2","typeLabel":"MacroPceData · object"},{"type":"object","title":"MacroImportExportData","description":"One import/export observation. Returned as an item of the economic-data\n`data` array when the `type` query parameter is `import-export`. Vietnam\n(`VN`) markets populate turnover values and the trade balance; other markets\npopulate price-index points (PPI/IPI/EPI). Fields not relevant to a market\nare `null`.\n","required":["id","createdAt","updatedAt","country","observationDate","tradeBalance","importTurnover","exportTurnover","importTurnoverUnits","exportTurnoverUnits","ppiPoints","ipiPoints","epiPoints"],"properties":{"id":{"type":"integer","description":"Unique identifier of the observation record.","example":4096,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.id","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"When the record was created.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"When the record was last updated.","example":"2026-04-01T08:00:00.000Z","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.updatedAt","typeLabel":"string\u003cdate-time>"},"country":{"type":"string","description":"ISO country code the observation belongs to.","example":"VN","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.country","typeLabel":"string"},"observationDate":{"type":"string","format":"date","description":"Date of the observation.","example":"2026-03-01","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.observationDate","typeLabel":"string\u003cdate>"},"tradeBalance":{"oneOf":[{"type":"number","description":"Exports minus imports for the period. Populated for `VN`; `null` for\nmarkets that report price-index points instead.\n","example":1200.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.tradeBalance.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exports minus imports for the period. Populated for `VN`; `null` for\nmarkets that report price-index points instead.\n","example":1200.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.tradeBalance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.tradeBalance","typeLabel":"number | null"},"importTurnover":{"oneOf":[{"type":"number","description":"Import turnover value; `null` for price-index markets.","example":30500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnover.oneOf.0","typeLabel":"number"},{"type":"null","description":"Import turnover value; `null` for price-index markets.","example":30500,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnover.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnover","typeLabel":"number | null"},"exportTurnover":{"oneOf":[{"type":"number","description":"Export turnover value; `null` for price-index markets.","example":31700.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnover.oneOf.0","typeLabel":"number"},{"type":"null","description":"Export turnover value; `null` for price-index markets.","example":31700.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnover.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnover","typeLabel":"number | null"},"importTurnoverUnits":{"oneOf":[{"type":"string","description":"Unit the import turnover is expressed in; `null` when not applicable.","example":"Million USD","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnoverUnits.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unit the import turnover is expressed in; `null` when not applicable.","example":"Million USD","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnoverUnits.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.importTurnoverUnits","typeLabel":"string | null"},"exportTurnoverUnits":{"oneOf":[{"type":"string","description":"Unit the export turnover is expressed in; `null` when not applicable.","example":"Million USD","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnoverUnits.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unit the export turnover is expressed in; `null` when not applicable.","example":"Million USD","isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnoverUnits.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.exportTurnoverUnits","typeLabel":"string | null"},"ppiPoints":{"oneOf":[{"type":"number","description":"Producer Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ppiPoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Producer Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ppiPoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ppiPoints","typeLabel":"number | null"},"ipiPoints":{"oneOf":[{"type":"number","description":"Import Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ipiPoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Import Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ipiPoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.ipiPoints","typeLabel":"number | null"},"epiPoints":{"oneOf":[{"type":"number","description":"Export Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.epiPoints.oneOf.0","typeLabel":"number"},{"type":"null","description":"Export Price Index points; `null` for turnover markets.","example":null,"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.epiPoints.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].oneOf.3.epiPoints","typeLabel":"number | null"}},"uniqueKey":"data.items.[INDEX].oneOf.3","typeLabel":"MacroImportExportData · object"}],"uniqueKey":"data.items.[INDEX]","typeLabel":"object | MacroCpiData · object | MacroPceData · object | MacroImportExportData · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"(object | MacroCpiData · object | MacroPceData · object | MacroImportExportData · object)[]"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"statusCode":200,"data":[{"country":"JP","quarter":"Q4 2025","gdp":"672199.300","gdpUnit":"Billion JPY","growthRate":0.6,"realGdp":null,"realGrowthRate":null,"dateFrom":"2025-10-01T00:00:00.000Z","dateTo":"2025-12-31T23:59:59.999Z"},{"country":"JP","quarter":"Q1 2026","gdp":"677233.400","gdpUnit":"Billion JPY","growthRate":0.8,"realGdp":null,"realGrowthRate":null,"dateFrom":"2026-01-01T00:00:00.000Z","dateTo":"2026-03-31T23:59:59.999Z"}],"meta":{"timestamp":"2026-06-19T08:50:42.471Z"}},"examples":{"Example":{"title":"Example","value":{"success":true,"statusCode":200,"data":[{"country":"JP","quarter":"Q4 2025","gdp":"672199.300","gdpUnit":"Billion JPY","growthRate":0.6,"realGdp":null,"realGrowthRate":null,"dateFrom":"2025-10-01T00:00:00.000Z","dateTo":"2025-12-31T23:59:59.999Z"},{"country":"JP","quarter":"Q1 2026","gdp":"677233.400","gdpUnit":"Billion JPY","growthRate":0.8,"realGdp":null,"realGrowthRate":null,"dateFrom":"2026-01-01T00:00:00.000Z","dateTo":"2026-03-31T23:59:59.999Z"}],"meta":{"timestamp":"2026-06-19T08:50:42.471Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9b0a5490-4f76-4ad9-9c16-ea8defef6b0d":{"description":"Invalid or missing parameter — bad enum, range, format, or a missing required query parameter.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned for every 4xx / 5xx response.","required":["success","statusCode","error"],"properties":{"success":{"type":"boolean","const":false,"description":"Always `false` for an error response.","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"type":"object","description":"Error detail object carried under `error` in the error envelope.","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Specific for authentication / quota errors\n(e.g. `API_KEY_REQUIRED`, `API_KEY_INVALID`, `FEATURE_NOT_IN_PLAN`,\n`RATE_LIMIT_EXCEEDED`). For validation (400) and not-found (404) the code\nis currently `INTERNAL_ERROR` and the HTTP status carries the semantics.\n","example":"API_KEY_INVALID","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"error.message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string | string[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"statusCode":400,"error":{"code":"INTERNAL_ERROR","message":["Invalid type parameter. Must be \"gdp\", \"cpi\", \"pce\", or \"import-export\"","Type parameter is required"]},"meta":{"error":"Bad Request","statusCode":400,"timestamp":"2026-06-19T08:34:08.081Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"statusCode":400,"error":{"code":"INTERNAL_ERROR","message":["Invalid type parameter. Must be \"gdp\", \"cpi\", \"pce\", or \"import-export\"","Type parameter is required"]},"meta":{"error":"Bad Request","statusCode":400,"timestamp":"2026-06-19T08:34:08.081Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"d6b93fba-a28d-48e3-a8ac-91e41c905bb4":{"description":"Missing, invalid, disabled or expired API key. Send a valid key in the `X-API-Key` header.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned for every 4xx / 5xx response.","required":["success","statusCode","error"],"properties":{"success":{"type":"boolean","const":false,"description":"Always `false` for an error response.","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"type":"object","description":"Error detail object carried under `error` in the error envelope.","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Specific for authentication / quota errors\n(e.g. `API_KEY_REQUIRED`, `API_KEY_INVALID`, `FEATURE_NOT_IN_PLAN`,\n`RATE_LIMIT_EXCEEDED`). For validation (400) and not-found (404) the code\nis currently `INTERNAL_ERROR` and the HTTP status carries the semantics.\n","example":"API_KEY_INVALID","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"error.message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string | string[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"statusCode":401,"error":{"code":"API_KEY_INVALID","message":"Invalid API key"},"meta":{"timestamp":"2026-06-19T08:34:08.023Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"statusCode":401,"error":{"code":"API_KEY_INVALID","message":"Invalid API key"},"meta":{"timestamp":"2026-06-19T08:34:08.023Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"03c7b259-6676-448d-bd68-4b77c2d4d7c6":{"description":"Your subscription plan does not include this data feature, or your key's scope denies it.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned for every 4xx / 5xx response.","required":["success","statusCode","error"],"properties":{"success":{"type":"boolean","const":false,"description":"Always `false` for an error response.","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"type":"object","description":"Error detail object carried under `error` in the error envelope.","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Specific for authentication / quota errors\n(e.g. `API_KEY_REQUIRED`, `API_KEY_INVALID`, `FEATURE_NOT_IN_PLAN`,\n`RATE_LIMIT_EXCEEDED`). For validation (400) and not-found (404) the code\nis currently `INTERNAL_ERROR` and the HTTP status carries the semantics.\n","example":"API_KEY_INVALID","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"error.message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string | string[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"statusCode":403,"error":{"code":"FEATURE_NOT_IN_PLAN","message":"Your plan does not include this feature"},"meta":{"timestamp":"2026-06-19T08:34:08.100Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"statusCode":403,"error":{"code":"FEATURE_NOT_IN_PLAN","message":"Your plan does not include this feature"},"meta":{"timestamp":"2026-06-19T08:34:08.100Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f1f6ed71-725f-4a2c-9df7-9a3fc9ac68d9":{"description":"Rate limit exceeded — you have consumed your plan's per-minute weight budget.\nWait until `X-RateLimit-Reset` (or `Retry-After` seconds) then retry.\n","headers":{"X-RateLimit-Limit":{"description":"Your plan's request-weight budget per 1-minute window.","schema":{"type":"integer","example":1000}},"X-RateLimit-Remaining":{"description":"Remaining request weight in the current 1-minute window.","schema":{"type":"integer","example":997}},"X-RateLimit-Reset":{"description":"Unix timestamp (seconds) when the current rate-limit window resets.","schema":{"type":"integer","format":"int64","example":1781857979}},"X-RateLimit-Weight-Used":{"description":"Request weight consumed by this call (see each endpoint's weight).","schema":{"type":"integer","example":3}},"Retry-After":{"description":"Seconds to wait before retrying. Present on 429 responses.","schema":{"type":"integer","example":30}}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned for every 4xx / 5xx response.","required":["success","statusCode","error"],"properties":{"success":{"type":"boolean","const":false,"description":"Always `false` for an error response.","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"type":"object","description":"Error detail object carried under `error` in the error envelope.","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Specific for authentication / quota errors\n(e.g. `API_KEY_REQUIRED`, `API_KEY_INVALID`, `FEATURE_NOT_IN_PLAN`,\n`RATE_LIMIT_EXCEEDED`). For validation (400) and not-found (404) the code\nis currently `INTERNAL_ERROR` and the HTTP status carries the semantics.\n","example":"API_KEY_INVALID","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"error.message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string | string[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"statusCode":429,"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Rate limit exceeded"},"meta":{"timestamp":"2026-06-19T08:34:09.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"statusCode":429,"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Rate limit exceeded"},"meta":{"timestamp":"2026-06-19T08:34:09.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"2000435f-07c4-4783-ab8f-3b177e23d962":{"description":"Unexpected server error. Retry after a short exponential backoff.","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned for every 4xx / 5xx response.","required":["success","statusCode","error"],"properties":{"success":{"type":"boolean","const":false,"description":"Always `false` for an error response.","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"statusCode":{"type":"integer","description":"Mirrors the HTTP status code.","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"error":{"type":"object","description":"Error detail object carried under `error` in the error envelope.","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code. Specific for authentication / quota errors\n(e.g. `API_KEY_REQUIRED`, `API_KEY_INVALID`, `FEATURE_NOT_IN_PLAN`,\n`RATE_LIMIT_EXCEEDED`). For validation (400) and not-found (404) the code\nis currently `INTERNAL_ERROR` and the HTTP status carries the semantics.\n","example":"API_KEY_INVALID","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"error.message.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Human-readable message, or a list of validation messages (400).","example":"Invalid API key","isRequired":true,"uniqueKey":"error.message.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string | string[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","description":"Response metadata. Always present; `timestamp` is the server time the response was generated.","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time","description":"Server time when the response was generated (ISO 8601).","example":"2026-06-19T08:31:59.478Z","isRequired":true,"uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":true,"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"statusCode":500,"error":{"code":"INTERNAL_ERROR","message":"Internal server error"},"meta":{"timestamp":"2026-06-19T08:34:10.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"statusCode":500,"error":{"code":"INTERNAL_ERROR","message":"Internal server error"},"meta":{"timestamp":"2026-06-19T08:34:10.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9f0354d0-9806-491e-8a42-41ff5e624403":{"HayInsightsApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your HayInsights API key (prefixed `apk_`). Create and manage keys in the\nHayInsights dashboard (Account → API keys).\n\nSend it in the `X-API-Key` header on **every** request to `/openapi/v1/*`.\nWhich data domains you may access and your request quota are both governed by\nthe subscription plan attached to the key — see the **Plans \u0026 features** and\n**Rate limits** guides.\n","scopes":[],"schemeName":"HayInsightsApiKey"}}},"servers":{"0e8d70bb-52bf-423d-b93d-77da6181da2c":{"url":"https://api-v2.hayinsights.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your HayInsights API key (prefixed `apk_`). Create and manage keys in the\nHayInsights dashboard (Account → API keys).\n\nSend it in the `X-API-Key` header on **every** request to `/openapi/v1/*`.\nWhich data domains you may access and your request quota are both governed by\nthe subscription plan attached to the key — see the **Plans \u0026 features** and\n**Rate limits** guides.\n","scopes":[],"schemeName":"HayInsightsApiKey"},"schema":{"title":"X-API-Key","type":"string","description":"Your HayInsights API key (prefixed `apk_`). Create and manage keys in the\nHayInsights dashboard (Account → API keys).\n\nSend it in the `X-API-Key` header on **every** request to `/openapi/v1/*`.\nWhich data domains you may access and your request quota are both governed by\nthe subscription plan attached to the key — see the **Plans \u0026 features** and\n**Rate limits** guides.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"HayInsightsApiKey","name":"X-API-Key"}],"title":"HayInsightsApiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"hayinsights","siteName":"HayInsights Open API","title":"Economic data series - HayInsights Open API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T09:24:28.429Z","originalFileLocation":"api-reference/macro/economic-data-series.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=\"system\"}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=\"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or import-export — for a country, over a chosen look-back window.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HayInsights Open API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_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/hayinsights/IGPjHz76REOz-qRi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Economic data series - HayInsights Open API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or import-export — for a country, over a chosen look-back window.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HayInsights Open API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.hayinsights.com/api-reference/macro/economic-data-series\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hayinsights.mintlify.site/_mintlify/api/og/v2?division=Macro\u0026amp;title=Economic+data+series\u0026amp;description=Time+series+for+a+selected+macroeconomic+indicator+%E2%80%94+GDP%2C+CPI%2C+PCE+or%0Aimport-export+%E2%80%94+for+a+country%2C+over+a+chosen+look-back+window.%0A\u0026amp;theme=185f9b5e5d996c23c0d08168\u0026amp;signature=7d85443983ef1ed887c0c2463faae6db50b2d8eb223ff76462807ba98d8a4c1b\">\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 data series - HayInsights Open API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or import-export — for a country, over a chosen look-back window.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hayinsights.mintlify.site/_mintlify/api/og/v2?division=Macro\u0026amp;title=Economic+data+series\u0026amp;description=Time+series+for+a+selected+macroeconomic+indicator+%E2%80%94+GDP%2C+CPI%2C+PCE+or%0Aimport-export+%E2%80%94+for+a+country%2C+over+a+chosen+look-back+window.%0A\u0026amp;theme=185f9b5e5d996c23c0d08168\u0026amp;signature=7d85443983ef1ed887c0c2463faae6db50b2d8eb223ff76462807ba98d8a4c1b\">\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/hayinsights/IGPjHz76REOz-qRi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HayInsights Open API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.hayinsights.com/api-reference/macro/economic-data-series\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/macro/economic-data-series.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.hayinsights.com/#organization\",\"name\":\"HayInsights Open API\",\"url\":\"https://developer.hayinsights.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hayinsights/w7ouUmWFSMYI1Ars/logo.svg?fit=max\u0026auto=format\u0026n=w7ouUmWFSMYI1Ars\u0026q=85\u0026s=c48347f2c9a762ef8ee28dfce9259983\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.hayinsights.com#website\",\"name\":\"HayInsights Open API\",\"url\":\"https://developer.hayinsights.com\",\"publisher\":{\"@id\":\"https://developer.hayinsights.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series#webpage\",\"url\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series\",\"name\":\"Economic data series\",\"description\":\"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or import-export — for a country, over a chosen look-back window.\",\"dateModified\":\"2026-11-10T09:24:28.429Z\",\"isPartOf\":{\"@id\":\"https://developer.hayinsights.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Macro\",\"item\":\"https://developer.hayinsights.com/api-reference/macro/gdp-growth-rate\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Economic data series\",\"item\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series#apireference\",\"headline\":\"Economic data series\",\"name\":\"Economic data series\",\"description\":\"Time series for a selected macroeconomic indicator — GDP, CPI, PCE or import-export — for a country, over a chosen look-back window.\",\"url\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series\",\"mainEntityOfPage\":{\"@id\":\"https://developer.hayinsights.com/api-reference/macro/economic-data-series#webpage\"},\"dateModified\":\"2026-11-10T09:24:28.429Z\",\"publisher\":{\"@id\":\"https://developer.hayinsights.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.hayinsights.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HayInsights Open API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"HayInsights Open API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/macro/economic-data-series.md","siteName":"HayInsights Open API","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Commodities","pages":[{"title":"List commodity prices","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/commodities","href":"/api-reference/commodities/list-commodity-prices"},{"title":"Featured commodities","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/commodities/featured","href":"/api-reference/commodities/featured-commodities"},{"title":"Top movers","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/commodities/movers","href":"/api-reference/commodities/top-movers"},{"title":"Gold vs DXY correlation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/commodities/gold-dxy","href":"/api-reference/commodities/gold-vs-dxy-correlation"},{"title":"Commodity price history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/commodities/{id}/history","href":"/api-reference/commodities/commodity-price-history"}]},{"group":"Crypto","pages":[{"title":"Crypto market overview","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/crypto","href":"/api-reference/crypto/crypto-market-overview"},{"title":"Crypto bubble map","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/crypto/bubble-map","href":"/api-reference/crypto/crypto-bubble-map"},{"title":"Crypto on-chain metrics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/crypto/onchain","href":"/api-reference/crypto/crypto-on-chain-metrics"},{"title":"Crypto derivatives metrics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/crypto/derivatives","href":"/api-reference/crypto/crypto-derivatives-metrics"},{"title":"Crypto market dominance","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/crypto/dominance","href":"/api-reference/crypto/crypto-market-dominance"}]},{"group":"ETF","pages":[{"title":"List ETFs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf","href":"/api-reference/etf/list-etfs"},{"title":"Top-performing ETFs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/top-performance","href":"/api-reference/etf/top-performing-etfs"},{"title":"Top ETFs by net flow","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/top-netflow","href":"/api-reference/etf/top-etfs-by-net-flow"},{"title":"ETF market heatmap","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/heatmap","href":"/api-reference/etf/etf-market-heatmap"},{"title":"BOJ ETF holdings history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/boj-holdings","href":"/api-reference/etf/boj-etf-holdings-history"},{"title":"BOJ ETF holdings latest","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/boj-holdings/latest","href":"/api-reference/etf/boj-etf-holdings-latest"},{"title":"Compare fund composition","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/compare/fund-composition","href":"/api-reference/etf/compare-fund-composition"},{"title":"Compare NAV growth","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/compare/nav-growth","href":"/api-reference/etf/compare-nav-growth"},{"title":"ETF NAV growth","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/nav-growth/{code}","href":"/api-reference/etf/etf-nav-growth"},{"title":"ETF info","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/{code}/info","href":"/api-reference/etf/etf-info"},{"title":"ETF holdings","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/{code}/holdings","href":"/api-reference/etf/etf-holdings"},{"title":"ETF price history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/{code}/prices-history","href":"/api-reference/etf/etf-price-history"},{"title":"ETF detail","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/{code}/detail","href":"/api-reference/etf/etf-detail"},{"title":"ETF / fund composition","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/etf/{code}/composition","href":"/api-reference/etf/etf-fund-composition"}]},{"group":"FX","pages":[{"title":"FX summary","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/fx/summary","href":"/api-reference/fx/fx-summary"},{"title":"FX table","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/fx/table","href":"/api-reference/fx/fx-table"},{"title":"FX correlation matrix","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/fx/correlation","href":"/api-reference/fx/fx-correlation-matrix"},{"title":"Emerging-market FX stress","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/fx/em-stress","href":"/api-reference/fx/emerging-market-fx-stress"}]},{"group":"Macro","pages":[{"title":"GDP growth rate","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/gdp-growth-rate","href":"/api-reference/macro/gdp-growth-rate"},{"title":"Latest macroeconomic market recap","description":"A point-in-time market recap bundling the latest Japanese equity / commodity\nindices, REITs, TOPIX, 3-month interbank reference rates and key currency\nrates into a single payload.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/market-recap","href":"/api-reference/macro/latest-macroeconomic-market-recap"},{"title":"Economic data series","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/economic-data","href":"/api-reference/macro/economic-data-series"},{"title":"Exchange rate series","description":"Daily closing exchange-rate history for a currency pair. Optionally limit the\nlook-back window or return only data before a given date.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/exchange-rate","href":"/api-reference/macro/exchange-rate-series"},{"title":"Population \u0026 unemployment","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/population","href":"/api-reference/macro/population-\u0026-unemployment"},{"title":"Central government debt (% of GDP)","deprecated":null,"version":null,"sidebarTitle":"Central government debt","openapi":"/openapi.yaml get /openapi/v1/macro/monetary-policy/central-government-debt","href":"/api-reference/macro/central-government-debt"},{"title":"Policy rates \u0026 bond yields","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/monetary-policy/rates-yields","href":"/api-reference/macro/policy-rates-\u0026-bond-yields"},{"title":"Japan FDI flows","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/fdi/flows","href":"/api-reference/macro/japan-fdi-flows"},{"title":"Japan FDI by region","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/fdi/by-region","href":"/api-reference/macro/japan-fdi-by-region"},{"title":"Japan FDI by industry","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/fdi/by-industry","href":"/api-reference/macro/japan-fdi-by-industry"},{"title":"Vietnam FDI flows","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/fdi/vn/flows","href":"/api-reference/macro/vietnam-fdi-flows"},{"title":"Vietnam FDI breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/fdi/vn/breakdown","href":"/api-reference/macro/vietnam-fdi-breakdown"},{"title":"Interbank rate history (US/JP)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/interbank-rates","href":"/api-reference/macro/interbank-rate-history-usjp"},{"title":"Japan TIBOR rates","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/interbank-rates/jp/tibor","href":"/api-reference/macro/japan-tibor-rates"},{"title":"Japan overnight call rate","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/interbank-rates/jp/overnight","href":"/api-reference/macro/japan-overnight-call-rate"},{"title":"Vietnam interbank rates","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/interbank-rates/vn","href":"/api-reference/macro/vietnam-interbank-rates"},{"title":"US Fed Funds rate — daily EFFR, percentiles, target range and IORB","deprecated":null,"version":null,"sidebarTitle":"Us fed funds daily","openapi":"/openapi.yaml get /openapi/v1/macro/fed-funds/us/daily","href":"/api-reference/macro/us-fed-funds-daily"},{"title":"US FOMC meeting schedule and rate decisions","deprecated":null,"version":null,"sidebarTitle":"Us fomc meetings","openapi":"/openapi.yaml get /openapi/v1/macro/fed-funds/us/fomc-meetings","href":"/api-reference/macro/us-fomc-meetings"},{"title":"Export/import turnover","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/trade/turnover","href":"/api-reference/macro/exportimport-turnover"},{"title":"Export/import by region","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/trade/by-region","href":"/api-reference/macro/exportimport-by-region"},{"title":"Japan GDP expenditure breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/japan/gdp-breakdown","href":"/api-reference/macro/japan-gdp-expenditure-breakdown"},{"title":"Japan central government debt breakdown","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/japan/central-gov-debt","href":"/api-reference/macro/japan-central-government-debt-breakdown"},{"title":"Manufacturing PMI by country (S\u0026P Global)","deprecated":null,"version":null,"sidebarTitle":"Pmi vn manufacturing","openapi":"/openapi.yaml get /openapi/v1/macro/pmi/{country}/manufacturing","href":"/api-reference/macro/pmi-vn-manufacturing"},{"title":"Vietnam GDP by sector (NSO)","deprecated":null,"version":null,"sidebarTitle":"Vietnam gdp by sector","openapi":"/openapi.yaml get /openapi/v1/macro/vietnam/gdp-by-sector","href":"/api-reference/macro/vietnam-gdp-by-sector"},{"title":"Vietnam GDP by sector — available periods","deprecated":null,"version":null,"sidebarTitle":"Vietnam gdp by sector periods","openapi":"/openapi.yaml get /openapi/v1/macro/vietnam/gdp-by-sector/periods","href":"/api-reference/macro/vietnam-gdp-by-sector-periods"},{"title":"Vietnam GDP by sector — time series","deprecated":null,"version":null,"sidebarTitle":"Vietnam gdp by sector series","openapi":"/openapi.yaml get /openapi/v1/macro/vietnam/gdp-by-sector/series","href":"/api-reference/macro/vietnam-gdp-by-sector-series"},{"title":"Vietnam CPI by component (NSO)","deprecated":null,"version":null,"sidebarTitle":"Vietnam cpi by component","openapi":"/openapi.yaml get /openapi/v1/macro/vietnam/cpi-by-component","href":"/api-reference/macro/vietnam-cpi-by-component"},{"title":"Indicator — GDP growth rate table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/gdp-growth-rate","href":"/api-reference/macro/indicator-—-gdp-growth-rate-table-usjpvn"},{"title":"Indicator — GDP per capita table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/gdp-per-capita","href":"/api-reference/macro/indicator-—-gdp-per-capita-table-usjpvn"},{"title":"Indicator — Central government debt table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/central-government-debt","href":"/api-reference/macro/indicator-—-central-government-debt-table-usjpvn"},{"title":"Indicator — Core CPI inflation table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/core-cpi","href":"/api-reference/macro/indicator-—-core-cpi-inflation-table-usjpvn"},{"title":"Indicator — Producer Price Index table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/ppi","href":"/api-reference/macro/indicator-—-producer-price-index-table-usjpvn"},{"title":"Indicator — PCE table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/core-pce","href":"/api-reference/macro/indicator-—-pce-table-usjpvn"},{"title":"Indicator — Export/Import price index table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/epi-ipi","href":"/api-reference/macro/indicator-—-exportimport-price-index-table-usjpvn"},{"title":"Indicator — Export/Import value \u0026 balance table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/export-import","href":"/api-reference/macro/indicator-—-exportimport-value-\u0026-balance-table-usjpvn"},{"title":"Indicator — Population table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/population","href":"/api-reference/macro/indicator-—-population-table-usjpvn"},{"title":"Indicator — Unemployment rate table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/unemployment-rate","href":"/api-reference/macro/indicator-—-unemployment-rate-table-usjpvn"},{"title":"Indicator — Exchange rates table","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/exchange-rates","href":"/api-reference/macro/indicator-—-exchange-rates-table"},{"title":"Indicator — Deposit rates table (US/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/deposit-rates","href":"/api-reference/macro/indicator-—-deposit-rates-table-usvn"},{"title":"Indicator — Government bond rates table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/government-bond-rates","href":"/api-reference/macro/indicator-—-government-bond-rates-table-usjpvn"},{"title":"Indicator — Interbank rates table (US/JP/VN)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/macro/indicators/interbank-rates","href":"/api-reference/macro/indicator-—-interbank-rates-table-usjpvn"},{"title":"Indicator — FDI table (US/JP/VN)","deprecated":null,"version":null,"sidebarTitle":"Indicator — FDI table (US/JP/VN)","openapi":"/openapi.yaml get /openapi/v1/macro/indicators/fdi","href":"/api-reference/macro/indicators-fdi"},{"title":"Indicator — Manufacturing PMI table (US/JP/VN)","deprecated":null,"version":null,"sidebarTitle":"Indicators pmi","openapi":"/openapi.yaml get /openapi/v1/macro/indicators/pmi","href":"/api-reference/macro/indicators-pmi"}]},{"group":"Real Estate","pages":[{"title":"List provinces","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/provinces","href":"/api-reference/real-estate/list-provinces"},{"title":"Representative land price per province","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/provinces/prices","href":"/api-reference/real-estate/representative-land-price-per-province"},{"title":"Wards of one province","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/provinces/{provinceId}/wards","href":"/api-reference/real-estate/wards-of-one-province"},{"title":"Ward choropleth GeoJSON for one province","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/provinces/{provinceId}/geojson","href":"/api-reference/real-estate/ward-choropleth-geojson-for-one-province"},{"title":"Transaction-level records for one ward (Japan only)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/wards/{wardId}/transactions","href":"/api-reference/real-estate/transaction-level-records-for-one-ward-japan-only"},{"title":"List priced road segments","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/real-estate/{country}/land-prices","href":"/api-reference/real-estate/list-priced-road-segments"}]},{"group":"News","pages":[{"title":"Latest market news","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/news/feed","href":"/api-reference/news/latest-market-news"},{"title":"Aggregate news sentiment","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/news/sentiment","href":"/api-reference/news/aggregate-news-sentiment"}]},{"group":"Calendar","pages":[{"title":"Economic calendar events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/calendar/events","href":"/api-reference/calendar/economic-calendar-events"}]},{"group":"Market","pages":[{"title":"Index snapshots","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/indices/snapshot","href":"/api-reference/market/index-snapshots"},{"title":"Global indices","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/global-indices","href":"/api-reference/market/global-indices"}]},{"group":"Equities","pages":[{"title":"Japan equity snapshot","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/{market}/equities/{code}","href":"/api-reference/equities/japan-equity-snapshot"},{"title":"Japan equity events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/{market}/equities/{code}/events","href":"/api-reference/equities/japan-equity-events"},{"title":"Japan equity daily prices","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/{market}/equities/{code}/prices","href":"/api-reference/equities/japan-equity-daily-prices"},{"title":"Japan equity financial statements","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/{market}/equities/{code}/financial-statements","href":"/api-reference/equities/japan-equity-financial-statements"},{"title":"Japan related equities","deprecated":null,"version":null,"openapi":"/openapi.yaml get /openapi/v1/market/{market}/equities/{code}/related-stocks","href":"/api-reference/equities/japan-related-equities"},{"title":"Vietnam equity daily prices","deprecated":null,"version":null,"sidebarTitle":"Vietnam equity daily prices","openapi":"/openapi.yaml get /openapi/v1/market/vn/equities/{code}/prices","href":"/api-reference/equities/vietnam-equity-daily-prices"},{"title":"Vietnam equity financial statements","deprecated":null,"version":null,"sidebarTitle":"Vietnam equity financial statements","openapi":"/openapi.yaml get /openapi/v1/market/vn/equities/{code}/financial-statements","href":"/api-reference/equities/vietnam-equity-financial-statements"},{"title":"Vietnam equity investor net flows","deprecated":null,"version":null,"sidebarTitle":"Vietnam equity investor net flows","openapi":"/openapi.yaml get /openapi/v1/market/vn/equities/{code}/netflows","href":"/api-reference/equities/vietnam-equity-investor-net-flows"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]}]},"basePath":"","title":"Economic data series - HayInsights Open API","buildId":"dpl_715YoAgvjTGBDdo8RtXmHKM22b5p","deploymentId":"dpl_715YoAgvjTGBDdo8RtXmHKM22b5p","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BvKnMd7F.js","utils-BMt52org.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CGXZuDGO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dl57XWH2.js","snippetPresets-CWd8CxSk.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BR-Wkc_D.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-YMmi08aZ.js","shallow-DBC1OB78.js","getApiPlaygroundDisplay-Be7mmEzP.js","CodeSnippet-B14o1TgQ.js","CodeSnippets-CJ2q3fTq.js","Page-Chgj7sZe.js","getPastedJson-DnpLXm8x.js","icon-BpkSFtdK.js","MethodPill-BO3zPf-g.js","DuplicateIcon-Bib3qwfw.js","createIcon-CY2noFo3.js","DynamicMarkdown-TAXIW2vN.js","SectionHeading-Dfs3Fmfw.js","axios-vUo_bRtp.js","Markdown-CGAo_eqA.js","clsx-BNa-H6W6.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-r2tNEC1n.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B7oWe6jc.js"]}