CryptoGrindCryptoGrindDocs
Open Dashboard

API reference

Prices

Last / mark prices across every monitored CEX and DEX — a sane-rate 1 Hz snapshot, not the raw firehose.

Prices come from the tick-writer's 1 Hz-deduped snapshot, so you get one clean value per exchange per symbol per second — never raw quote redistribution.

`latest` is a point-in-time REST snapshot; `live` streams the snapshot deltas over WebSocket.

GET latest

Latest snapshot for the requested filters.

GET/v1/prices/latest

Tier: machine-dev+ (x402 anonymous allowed)

Query parameters

ParameterTypeDescription
exchangecsvOne or more exchanges, e.g. binance,mexc.
marketstringspot | futures.
symbolstringExact symbol, e.g. BTC_USDT.
chaincsvDEX chains, e.g. solana,bsc.

Response

json
{
  "meta": { "trace": "c_4f2a…", "as_of": 1781000000.42, "count": 2 },
  "data": [
    { "exchange": "BINANCE", "market": "futures", "symbol": "BTC_USDT", "price": 67241.3, "mark_price": 67240.8, "ts": 1781000000 },
    { "exchange": "MEXC", "market": "spot", "symbol": "BTC_USDT", "price": 67235.0, "ts": 1781000000 }
  ]
}

WS live

Live 1 Hz price-snapshot stream.

WS/v1/prices/live

Tier: machine-dev+

Query parameters

ParameterTypeDescription
exchangestringFilter to one exchange.
marketstringspot | futures.
chaincsvDEX chains, e.g. solana,bsc.
symbolstringExact symbol.

Response

json
// Prices arrive in batched snapshot frames (not one record per frame):
{ "type": "prices", "ts": 1781000001.0, "count": 2,
  "data": [
    { "exchange": "MEXC", "market": "spot", "symbol": "BTC_USDT", "price": 67235.0, "ts": 1781000001 },
    { "exchange": "DEX-SOLANA", "market": "dex", "symbol": "WIF_USDC", "price": 2.41, "dex_network": "solana", "dex_id": "orca", "ts": 1781000001 }
  ] }
// First frame: { "type": "welcome", "family": "prices", "filters": { … }, "trace": "c_4f2a…" }

Event fields

Payloads are curated — only the fields below are exposed. New upstream fields never leak by default (allowlist policy). Every response carries a per-consumer trace watermark.

ParameterTypeDescription
exchangestringUppercase venue (CEX) or DEX-{CHAIN}.
marketstringspot | futures | dex.
symbolstringCanonical symbol.
pricefloatLast traded price.
mark_pricefloat?Mark price (futures).
dex_network / dex_idstring?Chain + DEX id — DEX records only.
tsintSnapshot unix timestamp.