Get Tickers

API Description

Retrieves 24-hour ticker statistics for trading pairs. This endpoint provides comprehensive market data including price changes, volume, and other key metrics for the last 24 hours.

HTTP Request

GET /v5/market/tickers

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Symbol name (e.g., BTCUSDT)

Response Parameters

Parameter	Type	Description
instrumentAddress	string	Contract address of the instrument
symbol	string	Trading pair symbol (e.g., BTC-USDM-EMG)
expiry	number	Expiry timestamp (0 for perpetual)
lastPrice	string	Last traded price
priceChange24h	string	Price change in 24 hours
priceChangePercent24h	string	Price change percentage in 24 hours
openPrice24h	string	Opening price 24 hours ago
highPrice24h	string	Highest price in 24 hours
lowPrice24h	string	Lowest price in 24 hours
volume24h	string	Trading volume in 24 hours (base asset)
quoteVolume24h	string	Trading volume in 24 hours (quote asset)
openTime24h	number	Opening time timestamp (24 hours ago)
closeTime24h	number	Closing time timestamp (current)
markPrice	string	Mark price for the instrument
spotPrice	string	Spot price of the underlying asset
openInterest	string	Open interest amount
fundingRate	string	Current funding rate
blockHeight	number	Block height of the data
timestamp	number	Data timestamp

Request Example

cURL

curl -X GET \
  'https://api.synfutures.com/v5/market/tickers?category=linear&symbol=BTCUSDT' \
  -H 'Content-Type: application/json'

JavaScript (Fetch)

const response = await fetch(
    "https://api.synfutures.com/v5/market/tickers?category=linear&symbol=BTCUSDT",
    {
        method: "GET",
        headers: {
            "Content-Type": "application/json",
        },
    }
);

const data = await response.json();
console.log(data);

Python (requests)

import requests

url = "https://api.synfutures.com/v5/market/tickers"
params = {
    'category': 'linear',
    'symbol': 'BTCUSDT'
}
headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
print(result)

Response Example

Success Response

{
    "code": 0,
    "data": [
        {
            "instrumentAddress": "string",
            "symbol": "BTC-USDM-EMG",
            "expiry": 0,
            "lastPrice": "string",
            "priceChange24h": "string",
            "priceChangePercent24h": "string",
            "openPrice24h": "string",
            "highPrice24h": "string",
            "lowPrice24h": "string",
            "volume24h": "string",
            "quoteVolume24h": "string",
            "openTime24h": 1499783499040,
            "closeTime24h": 1499869899040,
            "markPrice": "string",
            "spotPrice": "string",
            "openInterest": "string",
            "fundingRate": "string",
            "blockHeight": 0,
            "timestamp": 0
        }
    ],
    "msg": "string",
    "requestId": "string"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "string"
}