Tickers

Returns last price, 24h stats, and best bid/ask for a symbol.

Method	GET
Path	/v5/market/tickers
Auth	Authenticated.

Query parameters

Parameter	Type	Required	Description
category	string	Yes	linear.
symbol	string	No	Filter to a single symbol. Omit to list all.

Request

Python

from reference_client import sign_request, BASE_URL
import requests

headers, path = sign_request(
    "GET",
    "/v5/market/tickers",
    {"category": "linear", "symbol": "BTCUSDT"},
)
r = requests.get(BASE_URL + path, headers=headers)
print(r.json())

Java

HttpResponse<String> resp = client.send(
    "GET", "/v5/market/tickers", Map.of("category", "linear", "symbol", "BTCUSDT"), null);
System.out.println(resp.body());

Go

headers, p, err := SignRequest("GET", "/v5/market/tickers", map[string]string{"category": "linear", "symbol": "BTCUSDT"})
if err != nil { panic(err) }

req, _ := http.NewRequest("GET", BaseURL+p, nil)
for k, v := range headers { req.Header.Set(k, v) }
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))

Node.js

const {signRequest, BASE_URL} = require('./reference-client');

const {headers, path} = signRequest('GET', '/v5/market/tickers', {"category": "linear", "symbol": "BTCUSDT"});
const r = await fetch(BASE_URL + path, {
  method: 'GET',
  headers,
});
console.log(await r.json());

Response

{
  "retCode": 0,
  "retMsg": "OK",
  "result": {
    "category": "linear",
    "list": [
      {
        "symbol": "BTCUSDT",
        "lastPrice": "109740.00",
        "indexPrice": "109794.46",
        "markPrice": "109738.20",
        "prevPrice24h": "112844.30",
        "price24hPcnt": "-0.027509",
        "highPrice24h": "113433.00",
        "lowPrice24h": "109346.70",
        "volume24h": "65158.1580",
        "turnover24h": "7276685854.7812",
        "fundingRate": "-0.00000874",
        "nextFundingTime": "1756483200000",
        "ask1Price": "109740.00",
        "ask1Size": "0.237",
        "bid1Price": "109739.90",
        "bid1Size": "9.302"
      }
    ]
  }
}

Response parameters

Field	Type	Description
lastPrice	string	Last traded price.
indexPrice	string	Index price.
markPrice	string	Mark price (used for unrealised PnL).
prevPrice24h	string	Price 24h ago.
price24hPcnt	string	24h price change as a fraction (e.g. -0.0275 = -2.75%).
highPrice24h / lowPrice24h	string	24h high / low.
volume24h	string	24h base-asset volume.
turnover24h	string	24h quote-asset (USDT) turnover.
fundingRate	string	Current funding rate.
nextFundingTime	string	Next funding time (Unix ms).
bid1Price / bid1Size	string	Best bid price and size.
ask1Price / ask1Size	string	Best ask price and size.