主力成本變化趨勢

介面描述

取得代幣在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"
}