Skip to main content

GET /v1/prices

Returns current prices for a symbol across all exchanges.

Query Parameters

symbol
string
Filter by symbol. Omit for all symbols (returns averages).

Example

curl "https://api.crypton.dev/v1/prices?symbol=BTC"
{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": {
    "symbol": "BTC",
    "average_price": 71234.56,
    "exchanges": {
      "binance": { "price": 71235.00, "volume_24h": 1500000000.00, "updated_at": 1709639900000 },
      "coinbase": { "price": 71240.00, "volume_24h": 800000000.00, "updated_at": 1709639850000 },
      "okx": { "price": 71230.00, "volume_24h": 600000000.00, "updated_at": 1709639800000 }
    }
  }
}

Response Fields

data.average_price
number
Simple average price across all exchanges.
data.exchanges.*.price
number
Last traded price on this exchange (USD).
data.exchanges.*.volume_24h
number
24-hour volume (USD).
data.exchanges.*.updated_at
integer
Unix timestamp (ms).

Field Reference

FieldTypeDescriptionGranularityExample
average_pricenumberSimple arithmetic mean price across all reporting exchanges (USD)~30s aggregated71234.56
exchanges.*.pricenumberLast traded price on this exchange (USD)~30s per exchange71235.00
exchanges.*.volume_24hnumberRolling 24h trading volume on this exchange (USD)~30s per exchange1500000000.00
exchanges.*.updated_atintegerUnix ms when this price was last fetched~30s1709639900000

Data Sources

Price data from all 23 exchanges in the v2 registry (both spot and futures). Prices are last-traded prices, not mid-prices. Volume is 24h rolling. No volume-weighting on the average — it’s a simple mean.

Live Testing

# All symbols (averages only)
curl -s "https://api.crypton.dev/v1/prices" | jq 'to_entries[:5]'

# BTC with exchange breakdown
curl -s "https://api.crypton.dev/v1/prices?symbol=BTC" | jq .