交易行为趋势

接口描述

取得指定地址在区块鏈上对某个代幣的交易統計資料，支持通过指定代幣、指定链名、指定时间段查询鏈上交易情况。

使用场景：

• 适用于追踪特定地址的交易活跃度
• 适用于分析地址的買賣行为和交易频率

資料更新频率：每天更新一次

請求URL

• 方法：POST
• 路径：/open/v1/chain/trade/token/tradeCountTrend

积分消耗

• 消耗积分：2

前置条件

取得 vsTokenId

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

取得 coinKey

条件	说明	取得方式
已有 coinKey	直接使用缓存的 coinKey，无需重复查询	上下文自动提取
未有 coinKey	调用 POST /vs-token/detail 接口取得该代幣在不同鏈上的 coinKey	前置接口调用

取得 address

条件	说明	取得方式
已有 address	直接使用已知的持倉地址	用户输入
未有 address	调用 POST /chain/trade/token/holdPage 接口查询持倉地址列表	前置接口调用

請求参数

参数通过請求體（Body）以 JSON 格式传递。

参数名	類型	必需	描述
vsTokenId	long	是	代幣 ID
coinKey	string	是	代幣的 coinKey（链+合约地址），通过代幣详情取得
address	string	是	地址
startTime	long	否	开始时间（毫秒时间戳）
endTime	long	是	截止时间（毫秒时间戳）

回應欄位

仅展示 data 数组内每个对象的欄位结构：

欄位	類型	实际返回類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符号
name	string	string	代幣名称
date	long	long	时间（毫秒时间戳）
fromCount	integer	string	转出次数
toCount	integer	string	转入次数
fromAmount	number	string	转出金额
toAmount	number	string	转入金额
price	number	string	幣价

欄位业务含义

欄位	业务含义	使用建议
fromCount	转出交易次数	反映该地址的賣出活跃度
toCount	转入交易次数	反映该地址的買入活跃度
fromAmount	转出金额	正值表示资金流出该地址
toAmount	转入金额	正值表示资金流入该地址

請求示例

{
    "vsTokenId": 1,                         // 代幣 id
    "coinKey": "BTC_BTC",                    // 代幣的 coinKey（链+合约地址），通过代幣详情取得
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", // 地址
    "endTime": 1773479265534                  // 截止时间
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/chain/trade/token/tradeCountTrend' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "coinKey": "BTC_BTC",
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
    "endTime": 1773479265534
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/chain/trade/token/tradeCountTrend" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"coinKey\": \"BTC_BTC\",    \"address\": \"3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6\",    \"endTime\": 1773479265534}"

成功回應示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",           // 代幣 ID
            "symbol": "BTC",             // 代幣符号
            "name": "Bitcoin",           // 代幣名称
            "date": 1542038400000,       // 时间
            "fromCount": "1",             // 转出次数
            "toCount": "1",               // 转入次数
            "fromAmount": "0.01",         // 转出金额
            "toAmount": "0.01",           // 转入金额
            "price": "6359.49"            // 幣价
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1542124800000,
            "fromCount": "0",
            "toCount": "1",
            "fromAmount": "0",
            "toAmount": "1",
            "price": "5738.35"
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1542211200000,
            "fromCount": "2",
            "toCount": "1",
            "fromAmount": "20001",
            "toAmount": "20000",
            "price": "5648.03"
        }
        // ... 更多資料省略
    ],
    "requestId": "xxx-xxx-xxx"
}