宏观概览

查询关键宏观指标及近期经济事件。

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

可查询数据

返回数据
查询关键宏观指标及近期经济事件
每次返回什么
按接口参数查询对应数据。

认证

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

请求参数

响应

dataobject

业务数据

countnumber

本次返回条数

duration_msnumber

duration_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_totalnumber

indicators_total

next_events[]object[]

next_events

event_datedatetime

event_date

event_idstring

event_id

event_namestring

event_name

event_timestring

event_time

event_typestring

event_type

statement_urlstring

statement_url

statusstring

status

snapshot_timedatetime

观测时间

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。