大額交易

介面描述

取得指定代幣在BTC系列，EVM系列，波場系列20+主流公鏈上的大額交易資料。

使用情境：

適用於對代幣在鏈上的大額交易或異常交易流動監控追蹤及分析
適用於鲸鱼位址和交易所之間的大額轉帳監控
適用於追蹤大戶動向和市場異動預警

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

請求 URL

方法：POST
路徑：/open/v1/chain/trade/large

點數消耗

消耗點數：2

前置條件

取得 vsTokenId

條件	說明	取得方式
已有 vsTokenId	直接使用快取的 vsTokenId，無需重複查詢	上下文自動提取
未有 vsTokenId	呼叫 `POST /vs-token/list` 介面取得	前置介面呼叫

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
page	integer	否	當前頁，預設1
pageSize	integer	否	當前頁資料數量，預設10，最大100

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符號
name	string	string	代幣名稱
blockNumber	long	long	區塊高度
transIndex	integer	integer	交易在區塊列表中的下標
coinKey	string	string	幣識別
transHash	string	string	交易 hash
fromAddress	string	string	發出方位址
fromExchangeName	string	string	發出方標籤
toAddress	string	string	接收方位址
toExchangeName	string	string	接收方標籤
amount	number	string	交易金額
blockTime	long	long	區塊時間（毫秒時間戳）
coinInfo	object	object	代幣資訊
coinKey	string	string	幣識別
coinName	string	string	幣名
symbol	string	string	幣識別
protocol	string	string	協議
contractAddress	string	string	合約位址
chainName	string	string	鏈名
icon	string	string	圖標 URL
price	number	string	價格
addressInfo	object	object	位址資訊
address	string	string	位址
label	object	object	標籤
labelName	string	string	標簽章
iconUrl	string	string	圖標 URL
isContract	boolean	boolean	是否是合約位址
exchangeSymbol	string	string	交易所名稱
labelType	string	string	類型
reliability	integer	integer	可信度
nativeLabelName	string	string	原生標簽章
balance	number	string	餘額
profit	number	string	收益
exchangeInfo	object	object	交易所資訊
address	string	string	位址
name	string	string	名稱
icon	string	string	圖標
label	object	object	標籤
labelName	string	string	標簽章
iconUrl	string	string	圖標 URL
isContract	boolean	boolean	是否是合約位址
exchangeSymbol	string	string	交易所名稱
labelType	string	string	類型
reliability	integer	integer	可信度
nativeLabelName	string	string	原生標簽章
addresses	array	array	位址列表
amount	number	string	金額
exchangeCount	integer	integer	交易所計數

欄位業務含義

欄位	業務含義	使用建議
fromExchangeName	發出方標籤	識別轉出位址歸屬，如交易所名稱
toExchangeName	接收方標籤	識別轉入位址歸屬，如交易所名稱
amount	交易金額	大額交易的代幣數量，用於監控鲸鱼動向

請求範例

json

{
    "vsTokenId": 1,      // 代币 id
    "page": 1,           // 当前页，默认1
    "pageSize": 10       // 当前页数据数量，默认10，最大100
}

cURL 範例（Linux/macOS）

bash

curl --location --request POST 'http://${host}/api/open/v1/chain/trade/large' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "page": 1,
    "pageSize": 10
}'

cURL 範例（Windows CMD）

cmd

curl --location --request POST "http://${host}/api/open/v1/chain/trade/large" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"page\": 1,    \"pageSize\": 10}"

成功回應範例

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                           // 代币 ID
            "symbol": "BTC",                                             // 代币符号
            "name": "Bitcoin",                                           // 代币名称
            "blockNumber": 928673,                                       // 区块高度
            "transIndex": 2779,                                          // 交易在区块列表中的下标
            "coinKey": "BTC_BTC",                                        // 币标识
            "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36", // 交易 hash
            "fromAddress": "",                                           // 发出方地址
            "fromExchangeName": "",                                      // 发出方标签
            "toAddress": "",                                             // 接收方地址
            "toExchangeName": "Gate.io",                                 // 接收方标签
            "amount": "237.25912679",                                    // 交易金额
            "blockTime": 1766216779000,                                  // 区块时间
            "coinInfo": {
                "coinKey": "BTC_BTC",                                    // 币标识
                "coinName": "Bitcoin",                                   // 币名
                "symbol": "BTC",                                         // 币标识
                "protocol": "",                                          // 协议
                "contractAddress": "BTC",                                // 合约地址
                "chainName": "BTC",                                      // 链名
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg", // 图标 URL
                "price": "88161.61615187663"                             // 价格
            },
            "addressInfo": {
                "address": "",                                           // 地址
                "label": "",                                             // 标签
                "balance": "",                                           // 余额
                "profit": ""                                             // 收益
            },
            "exchangeInfo": {
                "address": "",                                           // 地址
                "name": "Gate.io",                                       // 名称
                "icon": "",                                              // 图标
                "label": "",                                             // 标签
                "addresses": [                                           // 地址列表
                    "1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9"
                ],
                "amount": "237.25912679",                                // 金额
                "exchangeCount": 1                                       // 交易所计数
            }
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "blockNumber": 928614,
            "transIndex": 619,
            "coinKey": "BTC_BTC",
            "transHash": "74ff8ba02659aadde9ba474d0c42216fd58e1635ea8dd4412047bddd41cf0538",
            "fromAddress": "",
            "fromExchangeName": "Coinbase",
            "toAddress": "",
            "toExchangeName": "",
            "amount": "292.07321743",
            "blockTime": 1766184312000,
            "coinInfo": {
                "coinKey": "BTC_BTC",
                "coinName": "Bitcoin",
                "symbol": "BTC",
                "protocol": "",
                "contractAddress": "BTC",
                "chainName": "BTC",
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg",
                "price": "88247.12283016353"
            },
            "addressInfo": {
                "address": "",
                "label": "",
                "balance": "",
                "profit": ""
            },
            "exchangeInfo": {
                "address": "",
                "name": "Coinbase",
                "icon": "",
                "label": "",
                "addresses": [
                    "3Eb17r7G4mwDzNn2oGNBD5mz8oDt5pSrv1",
                    "32V6a7K46pSb1XQNGdrmdE2wjgndVfJPet",
                    "3GPV1xVDrC7qFcdrpUmLF4N5wvWYmAjDrs"
                ],
                "amount": "273.35750643",
                "exchangeCount": 1
            }
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "blockNumber": 928574,
            "transIndex": 2827,
            "coinKey": "BTC_BTC",
            "transHash": "b98c1d2243e50c206c53262361b57c5732ff8e3491aa39552dac6e258615a0ca",
            "fromAddress": "",
            "fromExchangeName": "",
            "toAddress": "",
            "toExchangeName": "Crypto.com",
            "amount": "301.93699604",
            "blockTime": 1766163476000,
            "coinInfo": {
                "coinKey": "BTC_BTC",
                "coinName": "Bitcoin",
                "symbol": "BTC",
                "protocol": "",
                "contractAddress": "BTC",
                "chainName": "BTC",
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg",
                "price": "88287.06586315356"
            },
            "addressInfo": {
                "address": "",
                "label": "",
                "balance": "",
                "profit": ""
            },
            "exchangeInfo": {
                "address": "",
                "name": "Crypto.com",
                "icon": "",
                "label": "",
                "addresses": [
                    "bc1qr4dl5wa7kl8yu792dceg9z5knl2gkn220lk7a9"
                ],
                "amount": "301.93699604",
                "exchangeCount": 1
            }
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}

大額交易 ​

介面描述 ​

請求 URL ​

點數消耗 ​

前置條件 ​

請求參數 ​

回應欄位 ​

欄位業務含義 ​

請求範例 ​

cURL 範例（Linux/macOS） ​

cURL 範例（Windows CMD） ​

成功回應範例 ​

大額交易

介面描述

請求 URL

點數消耗

前置條件

請求參數

回應欄位

欄位業務含義

請求範例

cURL 範例（Linux/macOS）

cURL 範例（Windows CMD）

成功回應範例