Endpoints for derivatives market data (perpetuals and futures). This category includes 6 endpoints:
- /v5/exchange/derivatives/list - List derivatives exchanges
- /v5/exchange/derivatives/market-pairs/list/latest - Derivative market pairs by exchange
- /v5/cryptocurrency/derivatives/market-pairs/list/latest - Derivative market pairs by cryptocurrency
- /v5/derivatives/liquidations/quotes/latest - Latest Total Liquidations
- /v5/derivatives/liquidations/exchange/list/latest - Latest Liquidations by Exchange
- /v5/derivatives/liquidations/cryptocurrency/list/latest - Latest Liquidations by Cryptocurrency
List derivatives exchanges
Returns the list of derivatives exchanges CoinMarketCap tracks, sorted by 24-hour derivative volume in descending order by default. Only exchanges with active derivative trading (open interest or derivative volume > 0) are returned.
This endpoint is available on the following API plans:
- Free
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 100 exchanges returned (rounded up) and 1 additional call credit per convert option beyond the first.
query Parameters
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortOptionally specify the field used to sort the list of exchanges. Options: name, volume_24h, volume_24h_adjusted, exchange_score.
sort_dirOptionally specify the sort direction. Options: asc, desc.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in multiple currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own quote object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
List derivatives exchanges › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Derivative market pairs by exchange
Returns all active derivative market pairs that CoinMarketCap tracks for a given exchange.
This endpoint is available on the following API plans:
- Free
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
query Parameters
exchange_idA CoinMarketCap exchange ID. Example: "270"
exchange_slug^[0-9a-z-]+$Alternatively pass an exchange "slug" (URL friendly all lowercase shorthand version of name with spaces replaced with hyphens). Example: "binance". One "exchange_id" or "exchange_slug" is required.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sortOptionally specify the field used to sort market pairs. Options: volume_24h_strict, cmc_rank, cmc_rank_advanced, effective_liquidity.
sort_dirOptionally specify the sort direction. Options: asc, desc.
categoryThe derivative category of trading this market falls under. Options: all, perpetual, futures.
fee_typeThe fee type the exchange enforces for this market.
matched_id^\d+(?:,\d+)*$Optionally include one or more comma-delimited fiat or cryptocurrency IDs to filter market pairs by. For example ?matched_id=2781 would only return derivative markets matched against USD for the requested exchange. This parameter cannot be used when matched_symbol is used.
matched_symbol^[0-9A-Za-z$@\-,]+(?…Optionally include one or more comma-delimited fiat or cryptocurrency symbols to filter market pairs by. For example ?matched_symbol=USD would only return derivative markets matched against USD for the requested exchange. This parameter cannot be used when matched_id is used.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in multiple currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own quote object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Derivative market pairs by exchange › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Derivative market pairs by cryptocurrency
Returns all active derivative market pairs that CoinMarketCap tracks for a given cryptocurrency, across exchanges.
This endpoint is available on the following API plans:
- Free
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
query Parameters
crypto_idA CoinMarketCap cryptocurrency ID. Example: "1"
crypto_slug^[0-9a-z-]+$Alternatively pass a cryptocurrency "slug" (URL friendly all lowercase shorthand version of name with spaces replaced with hyphens). Example: "bitcoin".
crypto_symbol^[0-9A-Za-z$@\-]+$Alternatively pass a cryptocurrency symbol. Example: "BTC". One "crypto_id", "crypto_slug", or "crypto_symbol" is required.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use this parameter and the "start" parameter to determine your own pagination size.
sort_dirOptionally specify the sort direction. Options: asc, desc.
sortOptionally specify the field used to sort market pairs. Options: volume_24h_strict, cmc_rank, cmc_rank_advanced, effective_liquidity.
categoryThe derivative category of trading this market falls under. Options: all, perpetual, futures.
fee_typeThe fee type the exchange enforces for this market.
matched_id^\d+(?:,\d+)*$Optionally include one or more comma-delimited fiat or cryptocurrency IDs to filter market pairs by. For example ?matched_id=2781 would only return derivative markets matched against USD for the requested exchange. This parameter cannot be used when matched_symbol is used.
matched_symbol^[0-9A-Za-z$@\-,]+(?…Optionally include one or more comma-delimited fiat or cryptocurrency symbols to filter market pairs by. For example ?matched_symbol=USD would only return derivative markets matched against USD for the requested exchange. This parameter cannot be used when matched_id is used.
center_typeOptionally filter by exchange center type. Options: all, cex, dex.
convert^[0-9A-Za-z$@\-,]+(?…Optionally calculate market quotes in multiple currencies at once by passing a comma-separated list of cryptocurrency or fiat currency symbols. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found here. Each conversion is returned in its own quote object.
convert_id^\d+(?:,\d+)*$Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Derivative market pairs by cryptocurrency › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Latest Total Liquidations
Returns aggregate perpetual and futures liquidation values across every exchange that CoinMarketCap tracks, summed over rolling 1-hour, 4-hour, and 24-hour windows. These are the global headline figures shown on the CoinMarketCap liquidations chart.
Each window is reported three ways, and every value is denominated in the convert currency:
long_liquidations_*is the total value of long positions that were force-closed, meaning traders who were betting on a price increase had their positions liquidated through forced market sells.short_liquidations_*is the total value of short positions that were force-closed, meaning traders who were betting on a price decrease had their positions liquidated through forced market buys.total_liquidations_*is the combined value of the long and short liquidations in that same window.
All three windows are rolling and end at the moment your request is made, rather than aligning to fixed calendar boundaries. This endpoint returns the global totals only. If you need the same figures broken down per exchange or per cryptocurrency, use /v5/derivatives/liquidations/exchange/list/latest or /v5/derivatives/liquidations/cryptocurrency/list/latest instead.
This endpoint is available on the following API plans:
- Basic
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per request, plus 1 credit per convert / convert_id option beyond the first.
CMC equivalent page: coinmarketcap.com/charts/liquidations/
query Parameters
convert^[0-9A-Za-z$@\-]+(?:…Optionally calculate values in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Example: EUR,BTC. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in quotes[]. Cannot be used with convert_id. Defaults to USD when both are omitted.
convert_id^\d+(?:,\d+)*$Same as convert, but by CoinMarketCap currency ID instead of symbol. Example: convert_id=2781. Cannot be used with convert. Defaults to 2781 (USD) when both are omitted.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Latest Total Liquidations › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Latest Liquidations by Exchange
Returns a paginated, sorted list of the derivatives exchanges that CoinMarketCap tracks, each with its perpetual and futures liquidation values over rolling 1-hour, 4-hour, and 24-hour windows. This is the per-exchange leaderboard shown on the CoinMarketCap liquidations chart. When you call it without any filters, it returns every tracked exchange sorted by total_liquidations_24h in descending order.
Only exchanges that have an integrated liquidation feed are included in the results, and an exchange that is otherwise valid but has recorded no liquidations across any of the tracked windows is left out of the list entirely. Because of this, a request whose filter matches only such exchanges still succeeds: it returns an empty list with total_size set to 0 rather than failing with an error.
This endpoint covers exchanges only. To see the same liquidation values aggregated per cryptocurrency, use /v5/derivatives/liquidations/cryptocurrency/list/latest instead.
This endpoint is available on the following API plans:
- Basic
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 100 exchanges returned (rounded up), plus 1 credit per convert / convert_id option beyond the first.
CMC equivalent page: coinmarketcap.com/charts/liquidations/
query Parameters
exchange_id^\d+(?:,\d+)*$Optionally filter to one or more comma-separated CoinMarketCap exchange IDs. Example: 270,294. Cannot be used with exchange_slug.
exchange_slug^[0-9a-z-]+(?:,[0-9a…Alternatively filter by comma-separated exchange slugs. Example: binance,bybit. Cannot be used with exchange_id.
skip_invalidPass true to relax request validation: nonexistent identifiers in a filter list are skipped and valid ones are still returned. When false, any nonexistent value fails the request with 4001.
sortField to sort the list by (values compared in USD terms).
sort_dirDirection to order against the sort field.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use with start to page through the list.
convert^[0-9A-Za-z$@\-]+(?:…Optionally calculate values in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Example: EUR,BTC. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in quotes[]. Cannot be used with convert_id. Defaults to USD when both are omitted.
convert_id^\d+(?:,\d+)*$Same as convert, but by CoinMarketCap currency ID instead of symbol. Example: convert_id=2781. Cannot be used with convert. Defaults to 2781 (USD) when both are omitted.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Latest Liquidations by Exchange › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.
Latest Liquidations by Cryptocurrency
Returns a paginated, sorted list of cryptocurrencies, each with its perpetual and futures liquidation values over rolling 1-hour, 4-hour, and 24-hour windows, aggregated across every exchange that trades its derivatives. This is the per-coin leaderboard shown on the CoinMarketCap liquidations chart. When you call it without any filters, it returns every tracked cryptocurrency sorted by total_liquidations_24h in descending order.
A cryptocurrency that has no tracked derivative markets, or that has recorded no liquidations across any of the tracked windows, is left out of the list entirely. As a result, a request whose filter matches only such cryptocurrencies still succeeds: it returns an empty list with total_size set to 0 rather than failing with an error.
When you filter by symbol and that symbol is shared by more than one active cryptocurrency, every matching coin is returned. To target a single coin unambiguously, filter by crypto_id instead.
This endpoint is available on the following API plans:
- Basic
- Builder
- Startup
- Growth
- Professional
- Enterprise
Cache / Update frequency: Every 60 seconds.
Plan credit use: 1 call credit per 100 cryptocurrencies returned (rounded up), plus 1 credit per convert / convert_id option beyond the first.
CMC equivalent page: coinmarketcap.com/charts/liquidations/
query Parameters
crypto_id^\d+(?:,\d+)*$Optionally filter to one or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,1027. Cannot be combined with crypto_slug or symbol.
crypto_slug^[0-9a-z-]+(?:,[0-9a…Alternatively filter by comma-separated cryptocurrency slugs. Example: bitcoin,ethereum. Cannot be combined with crypto_id or symbol.
symbol^[0-9A-Za-z$@\-]+(?:…Alternatively filter by comma-separated cryptocurrency symbols. Example: BTC,ETH. Cannot be combined with crypto_id or crypto_slug.
skip_invalidPass true to relax request validation: nonexistent identifiers in a filter list are skipped and valid ones are still returned. When false, any nonexistent value fails the request with 4001.
sortField to sort the list by (values compared in USD terms).
sort_dirDirection to order against the sort field.
startOptionally offset the start (1-based index) of the paginated list of items to return.
limitOptionally specify the number of results to return. Use with start to page through the list.
convert^[0-9A-Za-z$@\-]+(?:…Optionally calculate values in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Example: EUR,BTC. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in quotes[]. Cannot be used with convert_id. Defaults to USD when both are omitted.
convert_id^\d+(?:,\d+)*$Same as convert, but by CoinMarketCap currency ID instead of symbol. Example: convert_id=2781. Cannot be used with convert. Defaults to 2781 (USD) when both are omitted.
Headers
X-CMC_PRO_API_KEYYour CoinMarketCap Pro API key
Latest Liquidations by Cryptocurrency › Responses
Successful
Results of your query returned as an object.
Standardized status object for API calls.