Economic Us Economic By Type

美国经济指标 - 按类型查询

1. 接口描述

| 项目 | 说明 | |------|------| | 接口名称 | 按类型查询美国经济指标（统一接口） | | 外部接口 | GET /api/v1/market/data/economic/us-economic | | 请求方式 | GET | | 适用场景 | 通过参数 type 指定指标类型，获取对应美国经济指标的时间序列（时间、前值、现值、发布日期）；支持 16 类指标 |

2. 请求参数

说明：type 为必填项，指定要查询的指标类型。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | type | string | 是 | 指标类型 | ism-manufacturing | 见下方「type 取值列表」 |

type 取值列表

| type 值 | 说明 | 单位/备注 | |---------|------|-----------| | ism-manufacturing | 美国 ISM 制造业指数 | 百分比 | | ism-non-manufacturing | 美国 ISM 非制造业指数 | 百分比 | | nonfarm-payroll | 美国非农就业人数变化 | 万人（接口已换算） | | trade-balance | 美国贸易帐 | 亿美元（接口已换算） | | unemployment-rate | 美国失业率 | 百分比 | | ppi-mom | 美国生产者物价指数月率 | 百分比 | | cpi-mom | 美国消费者物价指数月率 | 百分比 | | cpi-yoy | 美国消费者物价指数年率 | 百分比 | | core-cpi-mom | 美国核心消费者物价指数月率 | 百分比 | | core-cpi-yoy | 美国核心消费者物价指数年率 | 百分比 | | housing-starts | 美国新屋开工 | 万户（接口已换算） | | existing-home-sales | 美国成屋销售 | 万套 | | durable-goods-orders-mom | 美国耐用品订单月率 | 百分比 | | cb-consumer-confidence | 美国咨商会消费者信心指数 | 无单位 | | gdp-yoy-preliminary | 美国 GDP 年率初值 | 百分比；季度数据，时间为「YYYY年第N季度」 | | fed-funds-rate-upper | 美国央行公布利率决议（上限） | 百分比 |

3. 用法

从用户问题中识别要查的美国经济指标类型，对应到上表 type 值，执行：

python script/handler.py --type 

示例：

python script/handler.py --type ism-manufacturing
python script/handler.py --type nonfarm-payroll
python script/handler.py --type cpi-mom
python script/handler.py --type fed-funds-rate-upper

脚本输出 JSON 数组，按时间倒序，每项含 month（或季度格式）、prev_value、current_value、release_date，以表格展示给用户。

4. 响应说明

返回值为该指标的时间序列数组，按时间倒序。

单条记录结构（UsEconomicItem）

| 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |--------|------|------------|------|------| | month | String | 否 | 时间；月度为「YYYY年MM月」，季度（如 GDP）为「YYYY年第N季度」 | - | | prevvalue | Number/String | 是 | 上一期数值 | 见各 type 说明 | | currentvalue | Number/String | 是 | 当期数值，最新期可能为 null | 见各 type 说明 | | release_date | String | 否 | 发布日期，YYYY-MM-DD | - |

说明：部分指标为季度（如 gdp-yoy-preliminary），其余为月度。

5. 请求示例

GET /api/v1/market/data/economic/us-economic?type=ism-manufacturing

6. 注意事项

• 必须传入合法的 type，否则接口可能报错或返回空。
• 数组按时间倒序，最新在前；数值单位见各 type 说明。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FTShare-Lab
• Source: FTShare-Lab/FTShare-skills
• License: MIT
• Homepage: https://github.com/ftshare-lab/FTShare-skills

Install and usage instructions live in the source repository linked above.