板塊資金列表

介面描述

提供所有板塊類別在不同時間窗口下的即時資金累積資料。

使用情境：

• 適用於板塊輪動的資金累積資料監控
• 適用於發現热门板塊或資金異動板塊
• 適用於行業/板塊級別的資金流向分析

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