Get Tickers Information
Get real-time ticker statistics for spot trading pairs, including current prices, 24-hour price changes, trading volumes, and best bid/ask information.
HTTP Request
GET /api/v1/spot/market/tickers
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | No | Trading pair symbol (e.g., BTCUSDT). If omitted, returns all symbols |
Request Example
Single Symbol Request
curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/tickers?symbol=BTCUSDT"
All Symbols Request
curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/tickers"
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | string | Response code |
| msg | string | Response message |
| requestTime | number | Request timestamp in milliseconds |
| data | object/array | Response data (object for single symbol, array for all) |
| > symbol | string | Trading pair symbol |
| > high24h | string | Highest price in the last 24 hours |
| > open | string | Opening price 24 hours ago |
| > low24h | string | Lowest price in the last 24 hours |
| > lastPr | string | Latest price |
| > quoteVolume | string | Trading volume in quote currency (24h) |
| > baseVolume | string | Trading volume in base currency (24h) |
| > usdtVolume | string | Trading volume in USDT equivalent (24h) |
| > bidPr | string | Best bid price |
| > askPr | string | Best ask price |
| > bidSz | string | Best bid size |
| > askSz | string | Best ask size |
| > openUtc | string | Opening price at UTC 00:00 |
| > ts | string | Ticker timestamp in milliseconds |
| > changeUtc24h | string | Price change since UTC 00:00 |
| > change24h | string | 24-hour price change percentage |
Response Example
Success Response (Single Symbol)
{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": {
"symbol": "BTCUSDT",
"high24h": "93000",
"open": "92000",
"low24h": "90000",
"lastPr": "91234.56",
"quoteVolume": "100000000",
"baseVolume": "2000",
"usdtVolume": "100000000",
"bidPr": "91230.00",
"askPr": "91240.00",
"bidSz": "0.5",
"askSz": "0.6",
"openUtc": "91000",
"ts": "1763459280833",
"changeUtc24h": "-300",
"change24h": "-0.32%"
}
}
Success Response (All Symbols)
{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": [
{
"symbol": "BTCUSDT",
"high24h": "93000",
"open": "92000",
"low24h": "90000",
"lastPr": "91234.56",
"quoteVolume": "100000000",
"baseVolume": "2000",
"usdtVolume": "100000000",
"bidPr": "91230.00",
"askPr": "91240.00",
"bidSz": "0.5",
"askSz": "0.6",
"openUtc": "91000",
"ts": "1763459280833",
"changeUtc24h": "-300",
"change24h": "-0.32%"
},
{
"symbol": "ETHUSDT",
"high24h": "3500",
"open": "3400",
"low24h": "3350",
"lastPr": "3456.78",
"quoteVolume": "50000000",
"baseVolume": "15000",
"usdtVolume": "50000000",
"bidPr": "3456.00",
"askPr": "3457.00",
"bidSz": "10",
"askSz": "12",
"openUtc": "3420",
"ts": "1763459280833",
"changeUtc24h": "36.78",
"change24h": "1.67%"
}
]
}
Error Codes
| Code | Message |
|---|---|
| 40034 | symbol does not exist |
| 50010 | Ticker data not available |
| 50010 | No symbols found |