宏观指标

查询指定国家的宏观指标。

GET/api/v1/fundamentals/macro-indicator
数据域
公司基本面
解析层级
汇总
MCP 工具
fundamentals_query (task=macro_indicator)

可查询数据

返回数据
查询指定国家的宏观指标
每次返回什么
按接口参数查询对应数据。

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

指标与国家

指定指标与国家;country_code为兼容国家定位字段

indicatorstringquery示例CPI必填

填写一个宏观指标代码(精确匹配)。常用值:CPI、CORE_CPI、INFLATION_RATE、INFLATION_RATE_MOM、CORE_INFLATION_RATE、FEDERAL_FUNDS_RATE、GDP、GDP_GROWTH、GDP_ANNUAL_GROWTH、NONFARM_PAYROLL、UNEMPLOYMENT_RATE、LABOR_PARTICIPATION、CONSUMER_SPENDING、PPI、RETAIL_SALES、INDUSTRIAL_PRODUCTION、MONEY_SUPPLY_M2、CONSUMER_CONFIDENCE。数据覆盖因国家或地区而异

countrystringquery示例United States可选

国家或地区

兼容定位字段
country_codestringquery可选

国家或地区代码

查询模式

latest返回快照,timeseries返回可用历史序列;日期筛选仅用于timeseries

modestringquery示例latest可选

查询模式 · latest / timeseries

查询时间
fromstringquery可选

查询起点

tostringquery可选

查询终点

start_timestringquery可选

UTC起始时间(包含),支持RFC3339、日期或Unix秒;别名 from

end_timestringquery可选

UTC结束时间(不包含);仅填写日期时包含该UTC自然日;别名 to

返回选项
sizeintegerquery示例3可选

返回数量上限 · ≥ 1, ≤ 400

响应

dataobject

业务数据

countnumber

本次返回条数

countrystring

国家或地区

duration_msnumber

duration_ms

indicatorstring

宏观指标

latestobject

最新一期指标

snapshots[]object[]

指标快照列表

bea_series_codeunknown | null

bea_series_code

bls_series_idstring

bls_series_id

countrystring

国家或地区

datedatetime

统计日期

event_typestring

event_type

fred_series_idstring

fred_series_id

indicatorstring

宏观指标

indicator_cnstring

indicator_cn

modestring

查询模式

observation_datedatetime

observation_date

previousnumber

previous

reference_periodstring

数据所属期间

slugnamestring

slugname

sourcestring

source

timeseriesstring

timeseries

unitstring

计量单位

valuenumber

指标值

modestring

查询模式

sizenumber

返回数量上限

totalnumber

匹配记录总数

data_statusDataStatus

数据状态

empty_reasonunknown | null

空结果原因

errorunknown | null

结构化错误,无错误时为null

external_refs[]unknown[]

external_refs

lineage_refs[]unknown[]

lineage_refs

metadataobject

响应元数据

actual_taskstring

actual_task

data_statusDataStatus

数据状态

limitations[]unknown[]

补充说明

object_refs[]unknown[]

object_refs

route_reasonstring

route_reason

updated_atdatetime

数据更新时间

request_idstring

请求标识

source_refs[]unknown[]

source_refs

错误与降级

200
assets_resolve 名称多命中;从 data[] 候选确认。
200
对象已解析但无可用数据;empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效,或行情 listing 多命中;歧义响应含 required_params + candidates。
401
缺少 API Key,或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在;数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限;body 返回 retry_after,响应头同步返回 Retry-After。