Get futures exchange coins

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

Find futures coins listed on a specific exchange. On Coinranking, we use this endpoint on our futures exchange coin listings.

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

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/coins?referenceCurrencyUuid=5k-_VTxqtCEI
search (optional) String

Filter coins by name or symbol prefix.

Example:
https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/coins?search=bitcoin
orderBy (optional) String

Index to order the list by.

Default value: openInterest
Allowed values:
openInterest 24hVolume price fundingRate

Example:
https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/coins?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/coins?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/coins?limit=10
offset (optional) Number

Offset. Used for pagination.

Default value: 0

Example:
https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/coins?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/coins?cursor=eyJ0IjoxLC...

Code examples

curl 
curl 'https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/coins?orderBy=openInterest&limit=50' \
  -H 'x-access-token: your-api-key' \
  -G
JavaScript 
const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

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

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/futures/exchange/-zdvbieRdZ/coins?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;
Python 
import requests

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

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

print(response.text)

Response

json 
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 364
    },
    "coins": [
      {
        "uuid": "HIVsRcGKkPFtW",
        "symbol": "USDT",
        "name": "Tether USD",
        "color": "#22a079",
        "iconUrl": "https://cdn.coinranking.com/iqfxcAEV1/tether-usd-usdt.svg",
        "coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt",
        "rank": 1,
        "fundingRate": "-0.001612688073858576",
        "numberOfMarkets": 353,
        "price": "0.9996242792474768",
        "24hVolume": "35517299695.982635",
        "openInterest": "15034462427.315395"
      },
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "color": "#f7931A",
        "iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
        "rank": 2,
        "fundingRate": "0.00214894631298156",
        "numberOfMarkets": 4,
        "price": "63934.29464920227",
        "24hVolume": "17167029616.132805",
        "openInterest": "7511142889.425773"
      }
    ]
  },
  "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 coins listed on this exchange (not just the current page).
data.stats.total Number

Total number of matching coins.
data.coins Object[]

List of futures coins listed on this exchange.
data.coins.rank Number

The rank of this coin within this exchange result set.
data.coins.uuid String

UUID of the coin.
data.coins.symbol String

Coin symbol.
data.coins.name String

Name of the coin.
data.coins.color String|null

Hex color associated with the coin brand.
data.coins.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.coins.coinrankingUrl String

Where to find the coin on coinranking.com.
data.coins.price String|null

Latest futures price of the coin in the reference currency.
data.coins.24hVolume String|null

Total 24h volume of this coin on the selected futures exchange, in the reference currency.
data.coins.openInterest String|null

Open interest for this coin on the selected futures exchange, in the reference currency.
data.coins.fundingRate String|null

Open-interest-weighted average 8-hour funding rate for this coin on the selected exchange. Null when not available.
data.coins.numberOfMarkets Number|null

The number of futures markets for this coin on this exchange.
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

json 
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.
Previous

Futures exchanges

 Next

Futures exchange markets