板塊代幣資金
介面描述
取得指定板塊下，所有代幣的現貨或合約在不同時間窗口下的即時資金累積資料。
使用情境：
- 適用於板塊輪動監控中，對板塊下的代幣的資金情況監控
- 適用於發現板塊內的龙头代幣或異動代幣
- 適用於行業主題投資策略的資金分析
資料更新頻率：每5分鐘更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/trade/categories/CoinTradeList
點數消耗
- 消耗點數：
3
前置條件
取得 tag
| 條件 | 說明 | 取得方式 |
|---|---|---|
| 已有 tag | 直接使用快取的板塊標籤，無需重複查詢 | 上下文自動提取 |
| 未有 tag | 呼叫 POST /open/v1/trade/categories/getTradeList 介面取得所有板塊及其 tag | 前置介面呼叫 |
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| tag | string | 是 | 分類標籤 |
| tradeType | integer | 是 | 交易類型（1:現貨，2:合約） |
列舉值說明
tradeType - 交易類型
| 值 | 含义 |
|---|---|
| 1 | 現貨 |
| 2 | 合約 |
回應欄位
僅展示 data 陣列內每個物件的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 更新時間（毫秒時間戳） |
| tag | string | string | 板塊標籤 |
| tradeType | integer | integer | 交易類型（1:現貨，2:合約） |
| vsTokenId | long | string | 代幣ID |
| symbol | string | string | 代幣符號 |
| name | string | string | 代幣名稱 |
| categoriesTradeDataList | array | array | 板塊資金資料列表 |
| timeRange | string | string | 時間範圍 |
| timeParticleEnum | integer | integer | 統計時間粒度 |
| tradeInflow | number | number | 交易淨流入金額 (USD) |
欄位業務含義
| 欄位 | 業務含義 | 使用建議 |
|---|---|---|
| categoriesTradeDataList | 板塊資金資料 | 該代幣在不同時間粒度的資金淨流入資料，用於分析板塊內資金流向 |
| tradeInflow | 交易淨流入 | 正值表示資金流入，負值表示資金流出 |
請求範例
json
{
"tag": "AI", // 分类标签
"tradeType": 1 // 交易类型（1:现货，2:合约）
}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/trade/categories/CoinTradeList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"tag": "AI",
"tradeType": 1
}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/trade/categories/CoinTradeList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"tag\": \"AI\", \"tradeType\": 1}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1773298200000, // 更新时间
"tag": "AI", // 板块标签
"tradeType": 1, // 交易类型（1:现货，2:合约）
"vsTokenId": "1637", // 代币ID
"symbol": "RLC", // 代币符号
"name": "iExec RLC", // 代币名称
"categoriesTradeDataList": [
{
"timeRange": "H6", // 时间范围
"timeParticleEnum": 106, // 统计时间粒度
"tradeInflow": "3753.6444" // 交易净流入金额 (USD)
},
{
"timeRange": "M3",
"timeParticleEnum": 303,
"tradeInflow": "-716516.5178999999"
},
{
"timeRange": "D90",
"timeParticleEnum": 290,
"tradeInflow": "-716516.5179"
}
// ... 更多数据省略
]
},
{
"updateTime": 1773298200000,
"tag": "AI",
"tradeType": 1,
"vsTokenId": "1732",
"symbol": "NMR",
"name": "Numeraire",
"categoriesTradeDataList": [
{
"timeRange": "H6",
"timeParticleEnum": 106,
"tradeInflow": "-1088.4043000000013"
},
{
"timeRange": "M3",
"timeParticleEnum": 303,
"tradeInflow": "2671317.5315"
},
{
"timeRange": "D90",
"timeParticleEnum": 290,
"tradeInflow": "2671317.5314999996"
}
// ... 更多数据省略
]
},
{
"updateTime": 1773298200000,
"tag": "AI",
"tradeType": 1,
"vsTokenId": "1768",
"symbol": "ADX",
"name": "AdEx",
"categoriesTradeDataList": [
{
"timeRange": "H6",
"timeParticleEnum": 106,
"tradeInflow": "-11146.473400000003"
},
{
"timeRange": "M3",
"timeParticleEnum": 303,
"tradeInflow": "303446.2417000001"
},
{
"timeRange": "D90",
"timeParticleEnum": 290,
"tradeInflow": "303446.2417"
}
// ... 更多数据省略
]
}
],
"requestId": "xxx-xxx-xxx"
}