v1

latestOpenAPI 3.0.32026-08-04850206.9 KB

Markets

List tickers

Individual per-exchange markets (tickers), paginated. Filter by exchange, pair, instrument and volume/change ranges. USD volumes are numbers; prices are decimal strings.

get/api/v1/tickers

Query parameters

pageinteger nullable

Page number (1-based). Must be at least 1.

Example:1

Page number (1-based). Must be at least 1.

per_pageinteger nullable

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

Example:50

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

exchangestring nullable

Restrict to a single exchange by slug (omit on the per-exchange listing, which is already scoped). Must match the regex /^[a-z0-9-]{1,120}$/.

Example:binance-exchange

Restrict to a single exchange by slug (omit on the per-exchange listing, which is already scoped). Must match the regex /^[a-z0-9-]{1,120}$/.

pairinteger nullable

Restrict to a single pair by id. Must be at least 1.

Example:1

Restrict to a single pair by id. Must be at least 1.

instrument'future' | 'option' | 'swap' | 'spot' | 'margin' nullable

Instrument type: future, option, swap, spot or margin (plurals accepted).

Example:spot

Instrument type: future, option, swap, spot or margin (plurals accepted).

searchstring nullable

Free-text match on the ticker symbol. Must not be greater than 50 characters.

Example:BTC

Free-text match on the ticker symbol. Must not be greater than 50 characters.

min_volumenumber nullable

Only tickers with 24h USD volume at or above this value. Must be at least 0.

Example:1000000

Only tickers with 24h USD volume at or above this value. Must be at least 0.

max_volumenumber nullable

Only tickers with 24h USD volume at or below this value. Must be at least 0.

Example:100000000000

Only tickers with 24h USD volume at or below this value. Must be at least 0.

min_changenumber nullable

Only tickers with a 24h percentage change at or above this value.

Example:-50

Only tickers with a 24h percentage change at or above this value.

max_changenumber nullable

Only tickers with a 24h percentage change at or below this value.

Example:50

Only tickers with a 24h percentage change at or below this value.

sortstring nullable

A single sort field (prefix with - for descending). Sortable: volume_usd, change_24h, price_usd, updated. Defaults to -volume_usd. Must not be greater than 100 characters.

Example:-volume_usd

A single sort field (prefix with - for descending). Sortable: volume_usd, change_24h, price_usd, updated. Defaults to -volume_usd. Must not be greater than 100 characters.