主力成本变化趋势

接口描述

获取代币在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"
}