Skip to main content
GET
/
v1
/
exchanges
/
{exchange}
/
instruments
List instruments
curl --request GET \
  --url https://api.ticksupply.com/v1/exchanges/{exchange}/instruments \
  --header 'X-Api-Key: <api-key>'
{
  "items": [
    {
      "symbol": "BTCUSDT",
      "base": "BTC",
      "quote": "USDT",
      "instrument_type": "spot"
    },
    {
      "symbol": "ETHUSDT",
      "base": "ETH",
      "quote": "USDT",
      "instrument_type": "spot"
    }
  ],
  "total": 1500,
  "limit": 100,
  "next_page_token": "RVRIVVNEVg"
}

Authorizations

​
X-Api-Key
string
header
required

Your API key. Get one from the dashboard at https://app.ticksupply.com/api-keys

Path Parameters

​
exchange
string
required

Exchange code (e.g., "binance")

Query Parameters

​
search
string

Filter instruments by symbol (case-insensitive partial match)

​
base
string

Filter by base asset

​
quote
string

Filter by quote asset

​
instrument_type
enum<string>

Filter by instrument type

Available options:
spot,
perpetual,
futures,
option
​
limit
integer
default:100

Maximum number of results (1-1000)

Required range: 1 <= x <= 1000
​
page_token
string

Cursor for pagination

Response

Paginated list of instruments

​
items
object[]
required
​
total
integer<int64>
required

Total number of instruments matching filters

​
limit
integer
required

Items per page

​
next_page_token
string | null

Token for next page (null if no more pages)