主力成本变化趋势

接口描述

取得代幣在BTC系列、EVM系列、波场等多鏈上的大户实时平均持倉成本資料。

使用场景：

• 适用于指定代幣在鏈上的大户平均持倉成本資料取得
• 适用于主力行为分析
• 适用于评估当前价格相对主力成本的偏离程度

使用提示：

• 自然语言输入主力成本时，通常是查当前接口，提供鏈上的主力成本資料
• 自然语言查询主力分析、主力情况等综合语言需要调此接口

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

請求URL

• 方法：POST
• 路径：/open/v1/trade/getCoinTradeCost

积分消耗

• 消耗积分：2

前置条件

取得 vsTokenId

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

請求参数

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

参数名	類型	必需	描述
vsTokenId	long	是	代幣 ID
startTime	long	否	开始时间（毫秒时间戳）
endTime	long	否	结束时间（毫秒时间戳）

回應欄位

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

欄位	類型	实际返回類型	描述
vsTokenId	long	string	代幣ID
symbol	string	string	代幣符号
name	string	string	代幣名称
date	long	long	时间（毫秒时间戳）
price	number	string	当时的价格 (USD)
cost	number	string	主力成本 (USD)
balance	number	string	余额

欄位业务含义

欄位	业务含义	使用建议
cost	主力持倉成本	根据大额交易加权計算的主力平均持倉成本，用于判断当前价格相对主力的盈亏状態
balance	主力持倉余额	反映大户的持倉数量变化，持续增加表示主力在吸筹
price	代幣市场价格	与 cost 对比可計算价格偏离度：(price - cost) / cost * 100%

請求示例

{
    "vsTokenId": 1,           // 代幣 ID
    "startTime": 1770825600000, // 开始时间（时间戳）
    "endTime": 1773417600000    // 结束时间（时间戳）
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeCost' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTradeCost" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

成功回應示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",           // 代幣ID
            "symbol": "BTC",             // 代幣符号
            "name": "Bitcoin",           // 代幣名称
            "date": 1770825600000,       // 时间
            "price": "67308.54906296561", // 价格
            "cost": "60410.667759839053903122", // 主力成本
            "balance": "3878063.59266208"       // 余额
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1770912000000,
            "price": "66945.34755133065",
            "cost": "60419.968721902531478833",
            "balance": "3869188.04491703"
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1770998400000,
            "price": "66945.34755133065",
            "cost": "60530.743564442072031617",
            "balance": "3879695.17965919"
        }
        // ... 更多資料省略
    ],
    "requestId": "xxx-xxx-xxx"
}