Skip to main content

​
GET /v2/tickers

Returns ticker snapshots from a specific exchange.

​
Query Parameters

​
exchange
string
Exchange ID.
​
symbol
string
Filter by symbol.

​
Example

curl "https://api.crypton.dev/v2/tickers?exchange=okx"

{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": [
    {
      "exchange": "okx",
      "symbol": "BTC-USDT-SWAP",
      "last_price": 71000.50,
      "bid": 71000.00,
      "ask": 71001.00,
      "volume_24h": 600000000.00,
      "change_pct_24h": 1.25,
      "timestamp": 1709640000000
    }
  ]
}

​
Response Fields

​
data[].last_price
number
Last traded price (USD).
​
data[].bid
number | null
Best bid price.
​
data[].ask
number | null
Best ask price.
​
data[].volume_24h
number
24h volume (USD).
​
data[].change_pct_24h
number | null
24h price change (%).

​
Field Reference

FieldTypeDescriptionGranularityExample
exchangestringExchange ID—"okx"
symbolstringSymbol in exchange-native format—"BTC-USDT-SWAP"
last_pricenumberLast traded price (USD)~30s per exchange71000.50
bidnumber | nullBest bid price~30s per exchange71000.00
asknumber | nullBest ask price~30s per exchange71001.00
volume_24hnumber24h trading volume (USD)~30s per exchange600000000.00
change_pct_24hnumber | null24h price change (%). Null if exchange doesn’t provide~30s per exchange1.25
timestampintegerUnix ms when fetched~30s1709640000000

​
Data Sources

Ticker data from any exchange with has_tickers: true in the registry. All 23 exchanges support tickers. Data polled every ~30 seconds.

​
Live Testing

# All OKX tickers
curl -s "https://api.crypton.dev/v2/tickers?exchange=okx" | jq '.data[:3]'

# Specific symbol
curl -s "https://api.crypton.dev/v2/tickers?exchange=binance&symbol=BTCUSDT" | jq .