Skip to main content
GET
Derivatives Tickers List

Notes

  • Results match any of coin_ids and rwa_ids, then are narrowed by exchange_ids and contract_type.
  • Maximum of 250 IDs per request. Wildcard searches are not supported.
  • Unknown IDs are ignored. Returns [] if nothing matches.
  • Only tickers traded in the last 24 hours are included, based on last_traded_at. To get all tickers of an exchange, including ones not recently traded, use Derivatives Exchange Data by ID with include_tickers=all.
  • open_interest and volume_24h values are in USD.

SDK Examples

New to the SDK? Install and authenticate the client first:
TypeScript | Python

Authorizations

x-cg-pro-api-key
string
header
required

Learn how to set up your API key

Query Parameters

coin_ids
string
default:bitcoin

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

rwa_ids
string
default:gold

RWAs' IDs, comma-separated if querying more than 1 RWA. *refers to /rwas/list

exchange_ids
string
default:binance_futures

Derivatives exchanges' IDs, comma-separated if querying more than 1 exchange. *refers to /derivatives/exchanges/list

contract_type
enum<string>

Filter by contract type.

Available options:
perpetual,
futures
page
integer

Page through results. Default: 1

per_page
integer

Total results per page. Default: 100 Valid values: 1...250

order
enum<string>

Sort result by field.

Available options:
open_interest_desc,
open_interest_asc,
volume_desc,
volume_asc

Response

200 - application/json

List of derivative tickers

market
string
required

Derivative market name

symbol
string
required

Derivative ticker symbol

index_id
string
required

Identifier of the derivative's underlying index

coin_id
string | null
required

Derivative underlying asset coin ID

rwa_id
string | null
required

Derivative underlying asset RWA ID

exchange_id
string
required

Derivative exchange ID

price
string
required

Derivative ticker price

price_percentage_change_24h
number
required

Derivative ticker price percentage change in 24 hours

contract_type
string
required

Derivative contract type

index
number
required

Derivative underlying asset price

basis
number
required

Difference of derivative price and index price

spread
number
required

Derivative bid-ask spread

funding_rate
number
required

Derivative funding rate

open_interest
number
required

Derivative open interest

volume_24h
number
required

Derivative trading volume in 24 hours

last_traded_at
number
required

Derivative last traded time in UNIX timestamp

expired_at
number | null
required

Derivative expiry time in UNIX timestamp