---
title: "List tickers"
method: GET
path: "/api/v1/tickers"
tags: ["Markets"]
---

# List tickers

`GET /api/v1/tickers`

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

## Query parameters

- `page` integer, nullable — Page number (1-based). Must be at least 1.
- `per_page` integer, 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.
- `exchange` string, 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}$/.
- `pair` integer, nullable — 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).
- `search` string, nullable — Free-text match on the ticker symbol. Must not be greater than 50 characters.
- `min_volume` number, nullable — Only tickers with 24h USD volume at or above this value. Must be at least 0.
- `max_volume` number, nullable — Only tickers with 24h USD volume at or below this value. Must be at least 0.
- `min_change` number, nullable — Only tickers with a 24h percentage change at or above this value.
- `max_change` number, nullable — Only tickers with a 24h percentage change at or below this value.
- `sort` string, 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.

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)