代幣流向
接口描述
取得代幣在鏈上的持倉地址与中心化交易所（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"
}