代幣流向
介面描述
取得代幣在鏈上的持倉位址與中心化交易所（CEX）之間的資金流入/流出及變化率資料。
使用情境：
- 適用於判斷市場情緒和資金流向趨勢
- 適用於鏈上資金與交易所資金交互分析
資料更新頻率：每天更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/trade/getCoinTradeFlow
點數消耗
- 消耗點數：
2
前置條件
取得 vsTokenId
| 條件 | 說明 | 取得方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用快取的 vsTokenId，無需重複查詢 | 上下文自動提取 |
| 未有 vsTokenId | 呼叫 POST /vs-token/list 介面取得 | 前置介面呼叫 |
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代幣 ID |
回應欄位
僅展示 data 物件內的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| vsTokenId | long | string | 代幣ID |
| symbol | string | string | 代幣符號 |
| name | string | string | 代幣名稱 |
| coinTradeFlowDataV1Vos | array | array | 交易所資料列表 |
| timeRange | string | string | 時間範圍 |
| timeParticleEnum | integer | integer | 統計時間粒度 |
| tradeIn | number | string | 交易流入金額 (USD) |
| tradeOut | number | string | 交易流出金額 (USD) |
| tradeInNumber | number | string | 交易流入數量 |
| tradeOutNumber | number | string | 交易流出數量 |
| tradeInflow | number | string | 交易淨流入金額 (USD) |
| tradeAmount | number | string | 交易量 (USD) |
| tradeInflowChange | number | number | 交易淨流入變化率 |
欄位業務含義
| 欄位 | 業務含義 | 使用建議 |
|---|---|---|
| tradeInflow | 交易淨流入 | 正值表示資金流入交易所，利空行情；負值表示資金流出交易所，利好行情； |
| tradeInflowChange | 淨流入變化率 | 反映資金流入速度的增减，正值加速流入，負值加速流出 |
請求範例
json
{
"vsTokenId": 1 // 代币id
}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeFlow' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTradeFlow" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": {
"vsTokenId": "1", // 代币ID
"symbol": "BTC", // 代币符号
"name": "Bitcoin", // 代币名称
"coinTradeFlowDataV1Vos": [
{
"timeRange": "H1", // 时间范围
"timeParticleEnum": 101, // 统计时间粒度
"tradeIn": "18287486.3421524716", // 交易流入金额 (USD)
"tradeOut": "20431186.0069537593", // 交易流出金额 (USD)
"tradeInNumber": "261.06338392", // 交易流入数量
"tradeOutNumber": "292.2527353", // 交易流出数量
"tradeInflow": "-2143699.6648012877", // 交易净流入金额 (USD)
"tradeAmount": "38718672.3491062309", // 交易量 (USD)
"tradeInflowChange": -1.0504178361 // 交易净流入变化率
},
{
"timeRange": "H2",
"timeParticleEnum": 102,
"tradeIn": "65441054.6086384475",
"tradeOut": "25066077.7308015143",
"tradeInNumber": "935.91343814",
"tradeOutNumber": "358.55940114",
"tradeInflow": "40374976.8778369332",
"tradeAmount": "90507132.3394399618",
"tradeInflowChange": -0.0011861865
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeIn": "142822570.5758415342",
"tradeOut": "62024667.6912203477",
"tradeInNumber": "2047.31953966",
"tradeOutNumber": "889.23850568",
"tradeInflow": "80797902.8846211865",
"tradeAmount": "204847238.2670618819",
"tradeInflowChange": 0.4744189803
}
// ... 更多数据省略
]
},
"requestId": "xxx-xxx-xxx"
}