查詢最新行情信息

可獲取到快照的最新市場價格，最佳買賣價格，以及過去時間內的交易量等.

覆蓋範圍: 現貨 / USDT永續 / 反向合約

HTTP請求

GET /cloud/trade/v3/market/tickers

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. spot,linear,inverse
symbol	false	string	合約名稱

響應參數

Linear/Inverse

參數	類型	說明
category	string	產品類型
list	array	Object
> symbol	string	合約名稱
> lastPrice	string	最新市場成交價
> indexPrice	string	指數價格
> markPrice	string	標記價格
> prevPrice24h	string	24小時前的整點市價
> price24hPcnt	string	市場價格相對24h前變化的百分比
> highPrice24h	string	最近24小時的最高價
> lowPrice24h	string	最近24小時的最低價
> prevPrice1h	string	1小時前的整點市價
> openInterest	string	未平倉合約的數量
> openInterestValue	string	未平倉合約的價值
> turnover24h	string	最近24小時成交額
> volume24h	string	最近24小時成交量
> fundingRate	string	資金費率
> nextFundingTime	string	下次結算資金費用的時間 (毫秒)
> ask1Size	string	買1價的數量
> bid1Price	string	買1價
> ask1Price	string	賣1價
> bid1Size	string	買1價的數量

Spot

參數	類型	說明
category	string	產品類型
list	array	Object
> symbol	string	合約名稱
> bid1Price	string	買1價
> bid1Size	string	買1價的數量
> ask1Price	string	賣1價
> ask1Size	string	賣1價的數量
> lastPrice	string	最新市場成交價
> prevPrice24h	string	24小時前的整點市價
> price24hPcnt	string	市場價格相對24h前變化的百分比
> highPrice24h	string	最近24小時的最高價
> lowPrice24h	string	最近24小時的最低價
> turnover24h	string	最近24小時成交額
> volume24h	string	最近24小時成交量

---

請求示例

GET /cloud/trade/v3/market/tickers?category=inverse&symbol=BTCUSD HTTP/1.1
Host: openapi-testnet.zoomex.com

響應示例

Linear

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "category": "inverse",
    "list": [
        {
            "symbol": "BTCUSD",
            "lastPrice": "16597.00",
            "indexPrice": "16598.54",
            "markPrice": "16596.00",
            "prevPrice24h": "16464.50",
            "price24hPcnt": "0.008047",
            "highPrice24h": "30912.50",
            "lowPrice24h": "15700.00",
            "prevPrice1h": "16595.50",
            "openInterest": "373504107",
            "openInterestValue": "22505.67",
            "turnover24h": "2352.94950046",
            "volume24h": "49337318",
            "fundingRate": "-0.001034",
            "nextFundingTime": "1672387200000",
            "predictedDeliveryPrice": "",
            "basisRate": "",
            "deliveryFeeRate": "",
            "deliveryTime": "0",
            "ask1Size": "1",
            "bid1Price": "16596.00",
            "ask1Price": "16597.50",
            "bid1Size": "1",
            "basis": ""
        }
    ]
},
    "retExtInfo": {},
    "time": 1672376496682
}

Spot

```json
{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "category": "spot",
    "list": [
{
    "symbol": "BTCUSDT",
    "bid1Price": "20517.96",
    "bid1Size": "2",
    "ask1Price": "20527.77",
    "ask1Size": "1.862172",
    "lastPrice": "20533.13",
    "prevPrice24h": "20393.48",
    "price24hPcnt": "0.0068",
    "highPrice24h": "21128.12",
    "lowPrice24h": "20318.89",
    "turnover24h": "243765620.65899866",
    "volume24h": "11801.27771",
    "usdIndexPrice": "20784.12009279"
}
    ]
},
    "retExtInfo": {},
    "time": 1673859087947
}
```