板块资金列表

接口描述

提供所有板块類别在不同时间窗口下的实时资金积累資料。

使用场景：

• 适用于板块轮动的资金积累資料監控
• 适用于發現热门板块或资金异动板块
• 适用于行业/板块级别的资金流向分析

資料更新频率：每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"
}