Derivatives Tickers List
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/derivatives \
--header 'x-cg-pro-api-key: <api-key>'[
{
"market": "Binance (Futures)",
"symbol": "BTCUSDT",
"index_id": "BTC",
"coin_id": "bitcoin",
"rwa_id": null,
"exchange_id": "binance_futures",
"price": "77034.8",
"price_percentage_change_24h": -1.1733397846861013,
"contract_type": "perpetual",
"index": 76691.4276087,
"basis": -0.138769748300737,
"spread": 0.01,
"funding_rate": 0.004308,
"open_interest": 7497508223.83,
"volume_24h": 9623150393.3656,
"last_traded_at": 1779807819,
"expired_at": null
},
{
"market": "Binance (Futures)",
"symbol": "XAUUSDT",
"index_id": "XAU",
"coin_id": null,
"rwa_id": "gold",
"exchange_id": "binance_futures",
"price": "3591.86",
"price_percentage_change_24h": -3.870959116553918,
"contract_type": "perpetual",
"index": 3593.49822909,
"basis": -0.045388370100660796,
"spread": 0.01,
"funding_rate": 0.003886,
"open_interest": 506807819.05,
"volume_24h": 4793832682.103766,
"last_traded_at": 1795163454,
"expired_at": null
}
]Derivatives Tickers List
To query all the tickers from derivatives exchanges on CoinGecko
GET
/
derivatives
Derivatives Tickers List
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/derivatives \
--header 'x-cg-pro-api-key: <api-key>'[
{
"market": "Binance (Futures)",
"symbol": "BTCUSDT",
"index_id": "BTC",
"coin_id": "bitcoin",
"rwa_id": null,
"exchange_id": "binance_futures",
"price": "77034.8",
"price_percentage_change_24h": -1.1733397846861013,
"contract_type": "perpetual",
"index": 76691.4276087,
"basis": -0.138769748300737,
"spread": 0.01,
"funding_rate": 0.004308,
"open_interest": 7497508223.83,
"volume_24h": 9623150393.3656,
"last_traded_at": 1779807819,
"expired_at": null
},
{
"market": "Binance (Futures)",
"symbol": "XAUUSDT",
"index_id": "XAU",
"coin_id": null,
"rwa_id": "gold",
"exchange_id": "binance_futures",
"price": "3591.86",
"price_percentage_change_24h": -3.870959116553918,
"contract_type": "perpetual",
"index": 3593.49822909,
"basis": -0.045388370100660796,
"spread": 0.01,
"funding_rate": 0.003886,
"open_interest": 506807819.05,
"volume_24h": 4793832682.103766,
"last_traded_at": 1795163454,
"expired_at": null
}
]Notes
- Results match any of
coin_idsandrwa_ids, then are narrowed byexchange_idsandcontract_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 withinclude_tickers=all. open_interestandvolume_24hvalues are in USD.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.derivatives.get();
console.log(JSON.stringify(response, null, 2));
response = client.derivatives.get()
print(response)
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
Coins' IDs, comma-separated if querying more than 1 coin.
*refers to /coins/list
RWAs' IDs, comma-separated if querying more than 1 RWA.
*refers to /rwas/list
Derivatives exchanges' IDs, comma-separated if querying more than 1 exchange.
*refers to /derivatives/exchanges/list
Response
200 - application/json
List of derivative tickers
Was this page helpful?

