板块资金列表

接口描述

提供所有板块类别在不同时间窗口下的实时资金积累数据。

使用场景：

• 适用于板块轮动的资金积累数据监控
• 适用于发现热门板块或资金异动板块
• 适用于行业/板块级别的资金流向分析

数据更新频率：每5分钟更新一次

请求URL

• 方法：POST
• 路径：/open/v1/trade/categories/getTradeList

积分消耗

• 消耗积分：3

前置条件

无前置条件，可直接调用。

请求参数

参数通过请求体（Body）以 JSON 格式传递。

参数名	类型	必需	描述
tradeType	integer	是	交易类型（1:现货，2:合约）

枚举值说明

tradeType - 交易类型

值	含义
1	现货
2	合约

响应字段

仅展示 data 数组内每个对象的字段结构：

字段	类型	实际返回类型	描述
updateTime	long	long	更新时间（毫秒时间戳）
tradeType	integer	integer	交易类型（1:现货，2:合约）
tag	string	string	板块名称
tagsSimplified	string	string	板块名称(中文)
categoriesTradeDataList	array	array	板块资金数据列表
timeRange	string	string	时间范围
timeParticleEnum	integer	integer	统计时间粒度
tradeInflow	number	number	交易净流入金额 (USD)

字段业务含义

字段	业务含义	使用建议
tag	板块英文标识	用于后续查询板块下代币列表的参数
tagsSimplified	板块中文名称	用于展示给用户选择
categoriesTradeDataList	板块资金数据	该板块在不同时间粒度的资金净流入数据

请求示例

{
    "tradeType": 1   // 交易类型（1:现货，2:合约）
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/trade/categories/getTradeList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "tradeType": 1
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/trade/categories/getTradeList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"tradeType\": 1}"

成功响应示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773298200000,                 // 更新时间
            "tradeType": 1,                               // 交易类型（1:现货，2:合约）
            "tag": "Metaverse",                            // 板块名称
            "tagsSimplified": "元宇宙",                    // 板块名称(中文)
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",                     // 时间范围
                    "timeParticleEnum": 5,                 // 统计时间粒度
                    "tradeInflow": -167                     // 交易净流入金额 (USD)
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 7708
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": 25771
                }
                // ... 更多数据省略
            ]
        },
        {
            "updateTime": 1773298200000,
            "tradeType": 1,
            "tag": "Payments",
            "tagsSimplified": "Payments",
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",
                    "timeParticleEnum": 5,
                    "tradeInflow": 34939
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 294166
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": 804896
                }
                // ... 更多数据省略
            ]
        },
        {
            "updateTime": 1773298200000,
            "tradeType": 1,
            "tag": "Yzi",
            "tagsSimplified": "Yzi",
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",
                    "timeParticleEnum": 5,
                    "tradeInflow": 28510
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 67193
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": -34586
                }
                // ... 更多数据省略
            ]
        }
    ],
    "requestId": "xxx-xxx-xxx"
}