Get futures exchange markets

Growth This endpoint requires the growth plan or higher. Free, Basic and Startup plans can use preview access.

Find futures markets on a specific exchange. On Coinranking, we use this endpoint on our exchange futures markets page.

https://api.coinranking.com/v2/futures/exchange/:uuid/markets

Preview access

Free, Basic and Startup plans can test this endpoint with five successful requests per account per UTC day. Use the documented endpoint URL with your existing API key. Preview access is applied automatically. The allowance resets at 00:00 UTC.

All API keys, resource IDs, query parameters and pagination requests share this endpoint's allowance for your account. Failed requests do not consume the preview allowance. Successful previews also count toward your normal API usage, and your plan's result, historical-window and rate limits still apply. See endpoint previews for limits, response headers and quota errors.

Path parameters

Parameter	Description
uuid `String`	UUID of the exchange whose futures coins you want to retrieve. UUIDs can be found using the futures exchanges endpoint.

Query parameters

Parameter	Description
referenceCurrencyUuid (optional) `String`	UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Default value: yhjMzLPhuIDl Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?referenceCurrencyUuid=5k-_VTxqtCEI`
search (optional) `String`	Filter markets by base currency name, base currency symbol, quote currency name, or quote currency symbol. Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?search=BTC`
orderBy (optional) `String`	Index to order the list by. Default value: openInterest Allowed values: openInterest 24hVolume price lastTickerCreatedAt Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderBy=24hVolume`
orderDirection (optional) `String`	Applies direction to the orderBy query. Default value: desc Allowed values: desc asc Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderDirection=asc`
limit (optional) `Number`	Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Default value: 50 Size range: 0-5000 Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?limit=10`
offset (optional) `Number`	Offset. Used for pagination. Default value: 0 Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?offset=50`
cursor (optional) `String`	Cursor for pagination. Use the `nextCursor` value from the previous response to get the next page of results, or the `previousCursor` value to navigate back to the previous page. See Pagination for more information. Example: `https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?cursor=eyJ0IjoxLC...`

Code examples

curl 'https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderBy=openInterest&limit=50' \
  -H 'x-access-token: your-api-key' \
  -G

const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

fetch('https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderBy=openInterest&limit=50', options)
  .then((response) => response.json())
  .then((result) => console.log(result));

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderBy=openInterest&limit=50",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

import requests

headers = {
  'x-access-token': 'your-api-key'
}

response = requests.request("GET", "https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/markets?orderBy=openInterest&limit=50", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 394,
      "24hVolume": "171549552743.9990481060981808293",
      "openInterest": "71848691689.49994714899281474433"
    },
    "markets": [
      {
        "uuid": "DJs58RjCwUee",
        "rank": 51,
        "base": {
          "uuid": "hnfQfsYfeIGUQ",
          "symbol": "ETC",
          "name": "Ethereum Classic"
        },
        "quote": {
          "uuid": "HIVsRcGKkPFtW",
          "symbol": "USDT",
          "name": "Tether USD"
        },
        "exchange": {
          "uuid": "-zdvbieRdZ",
          "name": "Binance",
          "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
          "websiteUrl": "https://www.binance.com/"
        },
        "btcPrice": "0.000112095873066245",
        "markPrice": "29.13819956742563905268",
        "indexPrice": "29.14870948399999905234",
        "fundingRate": 0.000878,
        "fundingIntervalHours": 8,
        "recommended": true,
        "filters": [],
        "marketShare": "0.05",
        "price": "29.1405798759999990526",
        "24hVolume": "86971558.57710325317245026479",
        "minuteVolume": "60396.91567854391678130379",
        "openInterest": "64734242.96178600764580408022"
      },
      {
        "uuid": "aJtSHzmvEgpT",
        "rank": 52,
        "base": {
          "uuid": "tY54Rg0Gh",
          "symbol": "JTO",
          "name": "JITO"
        },
        "quote": {
          "uuid": "HIVsRcGKkPFtW",
          "symbol": "USDT",
          "name": "Tether USD"
        },
        "exchange": {
          "uuid": "-zdvbieRdZ",
          "name": "Binance",
          "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
          "websiteUrl": "https://www.binance.com/"
        },
        "btcPrice": "0.000011097006711552",
        "markPrice": "2.88479139879999990621",
        "indexPrice": "2.88740722211811990613",
        "fundingRate": 0.005,
        "fundingIntervalHours": 4,
        "recommended": true,
        "filters": [],
        "marketShare": "0.2",
        "price": "2.88479139879999990621",
        "24hVolume": "349706418.62741793703062468272",
        "minuteVolume": "242851.67960237355834948047",
        "openInterest": "64423138.43967040750552646156"
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "nextCursor": "eyJ0IjoxLC...",
    "previousCursor": null
  }
}

Response fields

Property	Description
status `String`	Status of the request. Allowed values: success
data.stats `Object`	Aggregate statistics across all futures markets on this exchange (not just the current page).
data.stats.total `Number`	Total number of matching futures markets on this exchange.
data.stats.24hVolume `String`	Total 24h volume of matching markets in the reference currency.
data.stats.openInterest `String`	Total open interest of matching markets in the reference currency.
data.markets `Object[]`	List of futures markets on this exchange.
data.markets.uuid `String`	UUID of the futures market.
data.markets.rank `Number`	Position in the ranked list for the selected ordering.
data.markets.base `Object`	The coin on the left side of the pair, which price is calculated in units of the quote.
data.markets.base.uuid `String`	UUID of the base currency.
data.markets.base.symbol `String`	Symbol of the base currency.
data.markets.base.name `String`	Name of the base currency.
data.markets.quote `Object`	The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USDT 65000 means 1 BTC is traded for 65000 USDT.
data.markets.quote.uuid `String`	UUID of the quote currency.
data.markets.quote.symbol `String`	Symbol of the quote currency.
data.markets.quote.name `String`	Name of the quote currency.
data.markets.exchange `Object`	Exchange this market belongs to.
data.markets.exchange.uuid `String`	UUID of the exchange.
data.markets.exchange.name `String`	Name of the exchange.
data.markets.exchange.iconUrl `String`	Location of the icon. Replace `.svg` with `.png` or `.webp`, optionally with `?size=WIDTHxHEIGHT` (e.g. `?size=28x28`) to control dimensions. See Icons for more details.
data.markets.exchange.websiteUrl `String\|null`	Website URL of the exchange.
data.markets.marketShare `String\|null`	This market's share of the total 24h volume across all markets on this exchange, as a percentage string.
data.markets.price `String\|null`	Latest futures price in the reference currency.
data.markets.markPrice `String\|null`	Mark price in the reference currency. Used by exchanges to calculate unrealized PnL and trigger liquidations.
data.markets.indexPrice `String\|null`	Index price in the reference currency. Typically a weighted average of spot prices across major exchanges.
data.markets.btcPrice `String\|null`	Price of the market expressed in Bitcoin.
data.markets.24hVolume `String\|null`	24-hour trading volume in the reference currency.
data.markets.minuteVolume `String\|null`	Trading volume in the last minute, in the reference currency.
data.markets.openInterest `String\|null`	Open interest in the reference currency.
data.markets.fundingRate `String\|null`	Funding rate as reported by the exchange for the most recent funding interval. Null when not available.
data.markets.fundingIntervalHours `Number\|null`	Funding interval in hours as reported by the exchange (e.g. 8 for standard perpetuals).
data.markets.recommended `Boolean`	Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges.
data.markets.filters `String[]`	An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins.
pagination `Object`	Pagination information. See Pagination for more details.
pagination.limit `Number`	The number of results per page.
pagination.hasNextPage `Boolean`	Whether there are more results available after the current page.
pagination.hasPreviousPage `Boolean`	Whether there are results available before the current page.
pagination.nextCursor `String\|null`	Cursor to use for the next page, or null if there are no more results.
pagination.previousCursor `String\|null`	Cursor to use for the previous page, or null if on the first page.

Error response

HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "EXCHANGE_NOT_FOUND",
  "message": "Exchange not found"
}

Error responses

Error	Description
EXCHANGE_NOT_FOUND `Object`	The exchange could not be found. Try another UUID.

Error	Description
VALIDATION_ERROR `Object`	The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE `Object`	The reference currency used in the request is not available. Choose another UUID.
INVALID_CURSOR `Object`	The cursor string is malformed or could not be decoded. Start pagination from the beginning without a cursor.
CURSOR_MISMATCH `Object`	The cursor was created with different orderBy or orderDirection parameters. Match the original parameters or start over.
PAGINATION_CONFLICT `Object`	Both cursor and offset parameters were provided. Use only one pagination method per request.