机会代幣消息

接口描述

取得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	机会等级	信号等级划分，用于筛选重要信号

請求示例

{
    "vsTokenId": 23335      // 代幣id
}

cURL 示例（Linux/macOS）

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）

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}"

成功回應示例

{
    "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"
}