资金异动消息

接口描述

获取对指定代币在中心化交易所上，现货或合约交易的主力资金异动的监控消息记录。

使用场景：

• 适用于资金异动监控列表下的代币，在AI实时追踪过程中的消息查询
• 适用于查看历史资金异动信号记录，包括但不限于短线/趋势行情异动、Alpha、FOMO 、止盈、止损等

使用提示：

• 信号类型需展示名称，出现多个alpha，fomo等消息时，统计各自出现的次数，同时出现时特别提醒
• 自然语言查询异动代币后，或查询异动信号，调用此接口
• 与资金异动代币列表接口配合使用，资金异动代币里的代币信号查询才查调用此接口

数据更新频率：每5分钟更新一次

请求URL

• 方法：POST
• 路径：/open/v1/ai/getFundsCoinMessageList

积分消耗

• 消耗积分：3

前置条件

获取 vsTokenId

条件	说明	获取方式
已有 vsTokenId	直接使用缓存的 vsTokenId，无需重复查询	上下文自动提取
未有 vsTokenId	调用 POST /vs-token/list 接口获取	前置接口调用

请求参数

参数通过请求体（Body）以 JSON 格式传递。

参数名	类型	必需	描述
vsTokenId	long	是	代币 ID
tradeType	integer	是	交易类型（1:现货, 2:合约）

枚举值说明

tradeType - 交易类型

值	含义
1	现货
2	合约

响应字段

仅展示 data 数组内每个对象的字段结构：

字段	类型	实际返回类型	描述
updateTime	long	long	更新时间（毫秒时间戳）
vsTokenId	long	string	代币 ID
symbol	string	string	代币符号
name	string	string	名称
tradeType	integer	integer	代币类型（1:现货; 2:合约; 3:交割合约）
price	number	string	币价
percentChange24h	number	number	24 小时涨跌幅
fundsMovementType	integer	integer	资金流动类型

字段业务含义

字段	业务含义	使用建议
fundsMovementType	资金异动类型	标识资金异动类型，如短线行情异动、趋势行情异动、Alpha等，同一时间多个类型时，可特别提醒，信号类型的对应关系不展示

请求示例

{
    "vsTokenId": 22974,      // 代币 id
    "tradeType": 1           // 交易类型（1:现货, 2:合约）
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/ai/getFundsCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 22974,
    "tradeType": 1
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/ai/getFundsCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 22974,    \"tradeType\": 1}"

成功响应示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773395700000,       // 更新时间
            "vsTokenId": "22974",                // 代币 ID
            "symbol": "TAO",                      // 代币符号
            "name": "Bittensor",                  // 名称
            "tradeType": 1,                       // 代币类型（1:现货; 2:合约; 3:交割合约）
            "price": "241.4",                     // 币价
            "percentChange24h": 15.36477852,      // 24 小时涨跌幅
            "fundsMovementType": 6                // 资金流动类型（6:涨幅）
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 4.56494468,
            "fundsMovementType": 3
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 15.6226012,
            "fundsMovementType": 1
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}