资金异动消息

接口描述

取得对指定代幣在中心化交易所上，现货或合约交易的主力资金异动的監控消息记錄。

使用场景：

• 适用于资金异动監控列表下的代幣，在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"
}