$npx -y skills add FTShare-Lab/FTShare-skills --skill economic-china-customs-trade-monthlyGet China customs import/export monthly data (海关进出口 月度). Use when user asks about 海关进出口, 出口, 进口, 进出口, 外贸, 中国出口进口, China customs trade.
| 1 | # 中国经济 - 海关进出口(月度) |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 海关进出口增减情况(月度汇总计算结果) | |
| 8 | | 外部接口 | GET /api/v1/market/data/economic/china-customs-trade | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取中国海关进出口月度数据,含出口/进口当月值、同比、环比及累计与累计同比等 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:该接口无需请求参数。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | - | - | - | 无需参数 | - | - | |
| 19 | |
| 20 | ## 3. 用法 |
| 21 | |
| 22 | 直接执行: |
| 23 | |
| 24 | ```bash |
| 25 | python script/handler.py |
| 26 | ``` |
| 27 | |
| 28 | 脚本输出 JSON 数组,按时间倒序,每项含 `month`(如 2025年03月份)、`export_current`/`export_yoy`/`export_mom`(当月出口及同比、环比)、`import_current`/`import_yoy`/`import_mom`(当月进口)、`cumulative_export`/`cumulative_export_yoy`、`cumulative_import`/`cumulative_import_yoy`(累计及同比)、`unit`、`currency`,以表格展示给用户。 |
| 29 | |
| 30 | ## 4. 响应说明 |
| 31 | |
| 32 | 返回值为海关进出口月度计算结果列表,按时间倒序。 |
| 33 | |
| 34 | ### CustomsTradeComputed 结构 |
| 35 | |
| 36 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 37 | |--------|------|------------|------|------| |
| 38 | | month | String | 否 | 月份,格式如 2025年03月份 | - | |
| 39 | | export_current | float | 是 | 当月出口额 | 见 unit | |
| 40 | | export_yoy | float | 是 | 当月出口额同比 | % | |
| 41 | | export_mom | float | 是 | 当月出口额环比 | % | |
| 42 | | import_current | float | 是 | 当月进口额 | 见 unit | |
| 43 | | import_yoy | float | 是 | 当月进口额同比 | % | |
| 44 | | import_mom | float | 是 | 当月进口额环比 | % | |
| 45 | | cumulative_export | float | 是 | 累计出口额 | 见 unit | |
| 46 | | cumulative_export_yoy | float | 是 | 累计出口额同比 | % | |
| 47 | | cumulative_import | float | 是 | 累计进口额 | 见 unit | |
| 48 | | cumulative_import_yoy | float | 是 | 累计进口额同比 | % | |
| 49 | | unit | String | 否 | 货币单位 | - | |
| 50 | | currency | String | 否 | 货币种类 | - | |
| 51 | |
| 52 | ## 5. 请求示例 |
| 53 | |
| 54 | ``` |
| 55 | GET /api/v1/market/data/economic/china-customs-trade |
| 56 | ``` |
| 57 | |
| 58 | ## 6. 注意事项 |
| 59 | |
| 60 | - 返回按月份汇总,格式如「2025年03月份」,列表已按时间倒序,最新月份在前。 |
| 61 | - 金额单位见 `unit`(通常为亿美元),同比/环比单位为 %,各数值字段可为 null。 |