机会代币消息
接口描述
获取AI通过多数据维度，对当前行情下具有上涨潜力的代币的追踪消息数据。
使用场景：
- 适用于当前行情下，对有上涨行情机会的代币，进行AI实时追踪的消息查询
- 适用于了解主力动作（入场、增持、减持、出逃等）
使用提示：
- 与机会代币列表接口配合使用，机会代币列表里的代币信号查询才查调用此接口
数据更新频率：每5分钟更新一次
请求URL
- 方法：
POST - 路径：
/open/v1/ai/getChanceCoinMessageList
积分消耗
- 消耗积分：
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 | 代币名称 |
| chanceMessageType | integer | integer | 预测类型 |
| scoring | number | number | 得分 |
| grade | integer | integer | 等级 |
| price | number | string | 币价 |
| percentChange24h | number | number | 24 小时跌涨幅 |
| gains | number | number | 涨幅 |
| decline | number | number | 跌幅 |
字段业务含义
| 字段 | 业务含义 | 使用建议 |
|---|---|---|
| chanceMessageType | 机会消息类型 | 标识主力动作类型，如入场、增持、减持、出逃等 |
| scoring | 机会得分 | 该信号的综合评分，分数越高信号越强 |
| grade | 机会等级 | 信号等级划分，用于筛选重要信号 |
请求示例
json
{
"vsTokenId": 23335 // 代币id
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 23335
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 23335}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1773071700000, // 更新时间
"vsTokenId": "23335", // VS Token ID
"symbol": "THE", // 代币符号
"name": "THENA", // 代币名称
"chanceMessageType": 30, // 预测类型
"scoring": 0.0, // 得分
"grade": 2, // 等级
"price": "0.2742", // 币价
"percentChange24h": 6.18293206, // 24 小时跌涨幅
"gains": 5.0743990000000005, // 涨幅
"decline": 0.363108 // 跌幅
},
{
"updateTime": 1773016500000,
"vsTokenId": "23335",
"symbol": "THE",
"name": "THENA",
"chanceMessageType": 5,
"scoring": 45.0,
"grade": 2,
"price": "0.2621",
"percentChange24h": 0.44075617,
"gains": 0.0,
"decline": 0.0
}
],
"requestId": "xxx-xxx-xxx"
}