Get Tickers

Query for the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.

Covers: Spot / USDT perpetual / Inverse contract

HTTP Request

GET /cloud/trade/v3/market/tickers

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. spot,linear,inverse
symbol	false	string	Symbol name

Response Parameters

Linear/Inverse

Parameter	Type	Comments
category	string	Product type
list	array	Object
> symbol	string	Symbol name
> lastPrice	string	Last price
> indexPrice	string	Index price
> markPrice	string	Mark price
> prevPrice24h	string	Market price 24 hours ago
> price24hPcnt	string	Percentage change of market price relative to 24h
> highPrice24h	string	The highest price in the last 24 hours
> lowPrice24h	string	The lowest price in the last 24 hours
> prevPrice1h	string	Market price an hour ago
> openInterest	string	Open interest size in Base
> openInterestValue	string	Open interest value in Quote
> turnover24h	string	Turnover for 24h
> volume24h	string	Volume for 24h
> fundingRate	string	Funding rate
> nextFundingTime	string	Next funding time (ms)
> ask1Size	string	Best ask size
> bid1Price	string	Best bid price
> ask1Price	string	Best ask price
> bid1Size	string	Best bid size

Spot

Parameter	Type	Comments
category	string	Product type
list	array	Object
> symbol	string	Symbol name
> bid1Price	string	Best bid price
> bid1Size	string	Best bid size
> ask1Price	string	Best ask price
> ask1Size	string	Best ask size
> lastPrice	string	Last price
> prevPrice24h	string	Market price 24 hours ago
> price24hPcnt	string	Percentage change of market price relative to 24h
> highPrice24h	string	The highest price in the last 24 hours
> lowPrice24h	string	The lowest price in the last 24 hours
> turnover24h	string	Turnover for 24h
> volume24h	string	Volume for 24h

---

Request Example

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

Response Example

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
}
```