资金快照
接口描述
获取指定代币在最近100天内任意时间点的资金积累数据，以及100天内指定时间的主力资金积累数据。
使用场景：
- 适用于短期内代币在不同时间点下的资金积累情况数据获取
- 适用于判断资金积累在一段时间内的变化趋势
- 适用于历史资金行为回溯分析
使用提示：
- 仅查询某天的数据但未指定具体时间点，默认查询UTC+8时间点的数据
- 自然语言查询主力资金趋势等综合语言需要调此接口
数据更新频率：每5分钟更新一次
请求URL
- 方法：
POST - 路径：
/open/v1/trade/getCoinTradeSnapshot
积分消耗
- 消耗积分：
3
前置条件
获取 vsTokenId
| 条件 | 说明 | 获取方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用缓存的 vsTokenId，无需重复查询 | 上下文自动提取 |
| 未有 vsTokenId | 调用 POST /vs-token/list 接口获取 | 前置接口调用 |
请求参数
参数通过请求体（Body）以 JSON 格式传递。
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | integer | 是 | 代币 ID |
| date | long | 是 | 指定日期（毫秒时间戳） |
响应字段
仅展示 data 对象内的字段结构：
| 字段 | 类型 | 实际返回类型 | 描述 |
|---|---|---|---|
| updateTime | integer | long | 更新时间（毫秒时间戳） |
| vsTokenId | integer | string | 代币 ID |
| symbol | string | string | 代币符号 |
| name | string | string | 代币名称 |
| hasSpotGoods | boolean | boolean | 是否存在现货数据 |
| spotMaxInflow | number | string | 现货主力资金积累 |
| spotGoodsList | array | array | 现货数据 |
| timeRange | string | string | 时间范围 |
| timeParticleEnum | integer | integer | 统计时间粒度 |
| tradeInflow | number | string | 交易净流入金额(USD) |
| tradeAmount | number | string | 交易量(USD) |
| hasContract | boolean | boolean | 是否存在合约数据 |
| contractMaxInflow | number | string | 合约主力资金积累 |
| contractList | array | array | 合约数据 |
| timeRange | string | string | 时间范围 |
| timeParticleEnum | integer | integer | 统计时间粒度 |
| tradeInflow | number | string | 交易净流入金额(USD) |
| tradeAmount | number | string | 交易量(USD) |
字段业务含义
| 字段 | 业务含义 | 使用建议 |
|---|---|---|
| spotMaxInflow | 现货主力积累 | 主力资金为现货交易的所有时间窗口中的最大资金净流入，主力积累为各时间窗口的资金数据 |
| contractMaxInflow | 合约主力积累 | 主力资金为现货交易的所有时间窗口中的最大资金净流入，主力积累为各时间窗口的资金数据 |
| date | 快照日期 | 查询的历史数据时间点，最小时间颗粒5分钟 |
请求示例
json
{
"vsTokenId": 1, // 代币 id
"date": 1773654600000 // 指定日期（时间戳）
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeSnapshot' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1,
"date": 1773654600000
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTradeSnapshot" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1, \"date\": 1773654600000}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1773654600000, // 更新时间
"vsTokenId": "1", // 代币 ID
"symbol": "BTC", // 代币符号
"name": "Bitcoin", // 代币名称
"hasSpotGoods": true, // 是否存在现货数据
"spotMaxInflow": "173206257.989364", // 现货主力资金积累
"spotGoodsList": [
{
"timeRange": "m5", // 时间范围
"timeParticleEnum": 5, // 统计时间粒度
"tradeInflow": "973669.0454980996", // 交易净流入金额(USD)
"tradeAmount": "4176136.897351299" // 交易量(USD)
},
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "1531287.2033347988",
"tradeAmount": "11822696.069185598"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "2668474.962980899",
"tradeAmount": "25890934.620040294"
}
// ... 更多数据省略
],
"hasContract": true, // 是否存在合约数据
"contractMaxInflow": "5115857220.793299", // 合约主力资金积累
"contractList": [
{
"timeRange": "m5", // 时间范围
"timeParticleEnum": 5, // 统计时间粒度
"tradeInflow": "7412113.461600001", // 交易净流入金额(USD)
"tradeAmount": "33097685.519799992" // 交易量(USD)
},
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "5682104.7779",
"tradeAmount": "69809754.7091"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-6355722.267499994",
"tradeAmount": "183233913.60549998"
}
// ... 更多数据省略
]
},
"requestId": "xxx-xxx-xxx"
}