$npx -y skills add FTShare-Lab/FTShare-skills --skill economic-us-economic-by-typeGet US economic indicator time series by type (美国经济指标按类型查询). Use when user asks about 美国 ISM, 美国非农, 美国 CPI/PPI, 美国失业率, 美国贸易帐, 美国新屋开工, 美国成屋销售, 美国耐用品订单, 美国咨商会信心指数, 美国 GDP 年率, 美国联邦基金利率, US economic data.
| 1 | # 美国经济指标 - 按类型查询 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 按类型查询美国经济指标(统一接口) | |
| 8 | | 外部接口 | GET /api/v1/market/data/economic/us-economic | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 通过参数 `type` 指定指标类型,获取对应美国经济指标的时间序列(时间、前值、现值、发布日期);支持 16 类指标 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:`type` 为必填项,指定要查询的指标类型。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | type | string | 是 | 指标类型 | ism-manufacturing | 见下方「type 取值列表」 | |
| 19 | |
| 20 | ### type 取值列表 |
| 21 | |
| 22 | | type 值 | 说明 | 单位/备注 | |
| 23 | |---------|------|-----------| |
| 24 | | ism-manufacturing | 美国 ISM 制造业指数 | 百分比 | |
| 25 | | ism-non-manufacturing | 美国 ISM 非制造业指数 | 百分比 | |
| 26 | | nonfarm-payroll | 美国非农就业人数变化 | 万人(接口已换算) | |
| 27 | | trade-balance | 美国贸易帐 | 亿美元(接口已换算) | |
| 28 | | unemployment-rate | 美国失业率 | 百分比 | |
| 29 | | ppi-mom | 美国生产者物价指数月率 | 百分比 | |
| 30 | | cpi-mom | 美国消费者物价指数月率 | 百分比 | |
| 31 | | cpi-yoy | 美国消费者物价指数年率 | 百分比 | |
| 32 | | core-cpi-mom | 美国核心消费者物价指数月率 | 百分比 | |
| 33 | | core-cpi-yoy | 美国核心消费者物价指数年率 | 百分比 | |
| 34 | | housing-starts | 美国新屋开工 | 万户(接口已换算) | |
| 35 | | existing-home-sales | 美国成屋销售 | 万套 | |
| 36 | | durable-goods-orders-mom | 美国耐用品订单月率 | 百分比 | |
| 37 | | cb-consumer-confidence | 美国咨商会消费者信心指数 | 无单位 | |
| 38 | | gdp-yoy-preliminary | 美国 GDP 年率初值 | 百分比;季度数据,时间为「YYYY年第N季度」 | |
| 39 | | fed-funds-rate-upper | 美国央行公布利率决议(上限) | 百分比 | |
| 40 | |
| 41 | ## 3. 用法 |
| 42 | |
| 43 | 从用户问题中识别要查的美国经济指标类型,对应到上表 `type` 值,执行: |
| 44 | |
| 45 | ```bash |
| 46 | python script/handler.py --type <type值> |
| 47 | ``` |
| 48 | |
| 49 | 示例: |
| 50 | |
| 51 | ```bash |
| 52 | python script/handler.py --type ism-manufacturing |
| 53 | python script/handler.py --type nonfarm-payroll |
| 54 | python script/handler.py --type cpi-mom |
| 55 | python script/handler.py --type fed-funds-rate-upper |
| 56 | ``` |
| 57 | |
| 58 | 脚本输出 JSON 数组,按时间倒序,每项含 `month`(或季度格式)、`prev_value`、`current_value`、`release_date`,以表格展示给用户。 |
| 59 | |
| 60 | ## 4. 响应说明 |
| 61 | |
| 62 | 返回值为该指标的时间序列数组,按时间倒序。 |
| 63 | |
| 64 | ### 单条记录结构(UsEconomicItem) |
| 65 | |
| 66 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 67 | |--------|------|------------|------|------| |
| 68 | | month | String | 否 | 时间;月度为「YYYY年MM月」,季度(如 GDP)为「YYYY年第N季度」 | - | |
| 69 | | prev_value | Number/String | 是 | 上一期数值 | 见各 type 说明 | |
| 70 | | current_value | Number/String | 是 | 当期数值,最新期可能为 null | 见各 type 说明 | |
| 71 | | release_date | String | 否 | 发布日期,YYYY-MM-DD | - | |
| 72 | |
| 73 | 说明:部分指标为季度(如 gdp-yoy-preliminary),其余为月度。 |
| 74 | |
| 75 | ## 5. 请求示例 |
| 76 | |
| 77 | ``` |
| 78 | GET /api/v1/market/data/economic/us-economic?type=ism-manufacturing |
| 79 | ``` |
| 80 | |
| 81 | ## 6. 注意事项 |
| 82 | |
| 83 | - 必须传入合法的 `type`,否则接口可能报错或返回空。 |
| 84 | - 数组按时间倒序,最新在前;数值单位见各 type 说明。 |