FTShare-Lab 美国经济指标 - 按类型查询
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 <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季度」 | - |
| prev_value | Number/String | 是 | 上一期数值 | 见各 type 说明 |
| current_value | 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 说明。
调用示例
python <RUN_PY> economic-us-economic-by-type --type cpi-yoy