宏观概览
查询关键宏观指标及近期经济事件。
GET/api/v1/fundamentals/macro-summary
可查询数据
- 返回数据
- 查询关键宏观指标及近期经济事件
- 每次返回什么
- 按接口参数查询对应数据。
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
响应
dataobject
业务数据
countnumber本次返回条数
duration_msnumberduration_ms
indicatorsobject
指标列表
cpi_yoyobject
消费价格指标
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
federal_funds_rateobject
联邦基金利率
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
gdp_growthobject
GDP 指标
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
nonfarm_payrollobject
非农就业指标
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
pce_yoyobject
个人消费支出指标
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
unemployment_rateobject
失业率
referencestring数据所属期间
trendstring变化方向
unitstring计量单位
valuenumber指标值
indicators_totalnumberindicators_total
next_events[]object[]
next_events
event_datedatetimeevent_date
event_idstringevent_id
event_namestringevent_name
event_timestringevent_time
event_typestringevent_type
statement_urlstringstatement_url
statusstringstatus
snapshot_timedatetime观测时间
totalnumber匹配记录总数
data_statusDataStatus数据状态
empty_reasonunknown | null空结果原因
errorunknown | null结构化错误,无错误时为null
external_refs[]unknown[]external_refs
lineage_refs[]unknown[]lineage_refs
metadataobject
响应元数据
actual_taskstringactual_task
data_statusDataStatus数据状态
limitations[]unknown[]补充说明
object_refs[]unknown[]object_refs
route_reasonstringroute_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。