风险代币消息
接口描述
获取AI通过多数据维度，对当前行情下具有下跌风险趋势的代币的追踪消息数据。
使用场景：
- 适用于当前行情下，对有下跌行情风险的代币，进行AI实时追踪的消息查询
- 适用于了解出货预警、下跌风险、反弹等风险信号
数据更新频率：每5分钟更新一次
请求URL
- 方法：
POST - 路径：
/open/v1/ai/getRiskCoinMessageList
积分消耗
- 消耗积分：
3
前置条件
获取 vsTokenId
| 条件 | 说明 | 获取方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用缓存的 vsTokenId，无需重复查询 | 上下文自动提取 |
| 未有 vsTokenId | 调用 POST /vs-token/list 接口获取 | 前置接口调用 |
请求参数
参数通过请求体（Body）以 JSON 格式传递。
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代币 ID |
响应字段
仅展示 data 数组内每个对象的字段结构：
| 字段 | 类型 | 实际返回类型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 更新时间（毫秒时间戳） |
| vsTokenId | long | string | VS Token ID |
| symbol | string | string | 代币名称 |
| name | string | string | 代币名称 |
| riskMessageType | integer | integer | 预测类型 |
| scoring | number | number | 得分（可能返回空字符串） |
| grade | integer | integer | 等级（可能返回空字符串） |
| price | number | string | 币价 |
| percentChange24h | number | number | 24 小时跌涨幅 |
| riskDecline | number | number | 风险跌幅 |
| rebound | number | number | 反弹 |
字段业务含义
| 字段 | 业务含义 | 使用建议 |
|---|---|---|
| riskMessageType | 风险消息类型 | 标识风险信号类型，如出货预警、下跌风险、反弹等 |
| riskDecline | 风险跌幅 | 推送后价格下跌幅度，用于验证风险预警准确性 |
| rebound | 反弹幅度 | 价格下跌后的反弹程度 |
请求示例
json
{
"vsTokenId": 38178 // 代币id
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 38178
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 38178}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1771317300000, // 更新时间
"vsTokenId": "38178", // VS Token ID
"symbol": "TRUTH", // 代币名称
"name": "Swarm Network", // 代币名称
"riskMessageType": 19, // 预测类型
"scoring": "", // 得分
"grade": "", // 等级
"price": "0.011799", // 币价
"percentChange24h": -2.32385979, // 24 小时跌涨幅
"riskDecline": 26.376997000000003, // 风险跌幅
"rebound": 6.613434999999999 // 反弹
},
{
"updateTime": 1771317000000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.013825",
"percentChange24h": -0.69409195,
"riskDecline": 15.444089,
"rebound": 4.466107
},
{
"updateTime": 1771316700000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.014154",
"percentChange24h": -0.69409195,
"riskDecline": 10.402556,
"rebound": 0.927115
}
// ... 更多数据省略
],
"requestId": "xxx-xxx-xxx"
}