中国经济 - 海关进出口（月度）

1. 接口描述

项目	说明
接口名称	海关进出口增减情况（月度汇总计算结果）
外部接口	GET /api/v1/market/data/economic/china-customs-trade
请求方式	GET
适用场景	获取中国海关进出口月度数据，含出口/进口当月值、同比、环比及累计与累计同比等

2. 请求参数

说明：该接口无需请求参数。

参数名	类型	是否必填	描述	取值示例	备注
-	-	-	无需参数	-	-

3. 用法

直接执行：

python script/handler.py

脚本输出 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，以表格展示给用户。

4. 响应说明

返回值为海关进出口月度计算结果列表，按时间倒序。

CustomsTradeComputed 结构

字段名	类型	是否可为空	说明	单位
month	String	否	月份，格式如 2025年03月份	-
export_current	float	是	当月出口额	见 unit
export_yoy	float	是	当月出口额同比	%
export_mom	float	是	当月出口额环比	%
import_current	float	是	当月进口额	见 unit
import_yoy	float	是	当月进口额同比	%
import_mom	float	是	当月进口额环比	%
cumulative_export	float	是	累计出口额	见 unit
cumulative_export_yoy	float	是	累计出口额同比	%
cumulative_import	float	是	累计进口额	见 unit
cumulative_import_yoy	float	是	累计进口额同比	%
unit	String	否	货币单位	-
currency	String	否	货币种类	-

5. 请求示例

GET /api/v1/market/data/economic/china-customs-trade

6. 注意事项

• 返回按月份汇总，格式如「2025年03月份」，列表已按时间倒序，最新月份在前。
• 金额单位见 unit（通常为亿美元），同比/环比单位为 %，各数值字段可为 null。

调用示例

python <RUN_PY> economic-china-customs-trade-monthly