查詢資產詳情

查詢指定鏈上代幣的持倉詳情，包含盈虧及成本數據。

信息

• 代幣通過 chainCode + tokenAddress 識別 — 可從 查詢資產列表 或 獲取業務代幣列表 獲取
• 響應中 assetList 數組包含 0 或 1 個元素；空數組表示用戶未持有該代幣
• 使用 tradeFlag 判斷代幣是否可通過 執行贖回 賣出

HTTP 請求

POST/v5/alpha/trade/asset-detail

請求參數

參數	是否必需	類型	說明
chainCode	true	string	區塊鏈代碼，如 ETH、SOL、BSC
tokenAddress	true	string	指定鏈上的代幣合約地址

響應參數

參數	類型	說明
assetList	array	資產詳情，包含 0 或 1 個元素。空數組表示用戶未持有該代幣
> chainCode	string	區塊鏈代碼
> chainIconUrl	string	鏈圖標 URL
> tokenAddress	string	代幣合約地址
> tokenCode	string	DEX_<id> 格式的代幣代碼，用於報價及執行接口
> tokenSymbol	string	代幣符號
> tokenDecimals	integer	代幣小數精度
> tokenIconUrlDay	string	代幣圖標 URL（淺色模式）
> tokenIconUrlNight	string	代幣圖標 URL（深色模式）
> tokenAmount	string	持倉數量
> tokenAmountUsd	string	持倉市值（USD）
> tradeFlag	integer	是否可交易。0: 不可交易，1: 可交易
> pnl	string	未實現盈虧（USD），正數為盈利。無成本數據時為 null
> pnlRatio	string	盈虧比率（小數），如 0.15 = +15%。無成本數據時為 null
> costPrice	string	平均成本價。無成本數據時為 null
> lastPrice	string	當前市場價格
> costTotalValue	string	總成本（USD）。無成本數據時為 null
> assetStatus	integer	代幣生命週期狀態。0: 運行中，1: 即將下線，2: 已下線
> announcementUrl	string	下線公告 URL。assetStatus 為 1 或 2 時存在
> estimatedOfflineTime	integer	預計下線時間（ms）。assetStatus=1 時存在
> delistingTime	integer	實際下線時間（ms）。assetStatus=2 時存在

請求示例

HTTP

POST /v5/alpha/trade/asset-detail HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "chainCode": "ETH",
    "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}

Python

Node.js

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "assetList": [
            {
                "chainCode": "ETH",
                "chainIconUrl": "https://example.com/eth.png",
                "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
                "tokenCode": "DEX_123",
                "tokenSymbol": "PEPE",
                "tokenDecimals": 18,
                "tokenIconUrlDay": "https://example.com/pepe-day.png",
                "tokenIconUrlNight": "https://example.com/pepe-night.png",
                "tokenAmount": "50000000",
                "tokenAmountUsd": "500.00",
                "tradeFlag": 1,
                "pnl": "75.00",
                "pnlRatio": "0.15",
                "costPrice": "0.0000085",
                "lastPrice": "0.00001",
                "costTotalValue": "425.00",
                "assetStatus": 0
            }
        ]
    },
    "retExtInfo": {},
    "time": 1704067200000
}