Get futures coins

Professional This endpoint requires the professional plan or higher

Get a list of coins with futures data. The response includes global futures statistics and a paginated list of coins ordered by open interest by default. All price, volume, and open interest values are converted to the requested reference currency.

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

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

UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get specific coins.

Example:
https://api.coinranking.com/v2/futures/coins?uuids[]=Qwsogvtv82FCd&uuids[]=razxDUgYGNAdQ
symbols (optional) Array

Symbols to filter the list on. Note that symbols are not unique. Should you need a specific coin, use the UUIDs filter instead.

Example:
https://api.coinranking.com/v2/futures/coins?symbols[]=BTC&symbols[]=ETH
search (optional) String

Filter coins by name or symbol prefix.

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

Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000

Example:
https://api.coinranking.com/v2/futures/coins?limit=10
offset (optional) Number

Offset. Used for pagination.

Default value: 0

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

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 764,
      "totalCoins": 764,
      "totalMarkets": 4134,
      "totalExchanges": 10,
      "totalOpenInterest": "71745231130.26796",
      "total24hVolume": "105215795157",
      "fundingRate": "-0.00045426072917752"
    },
    "coins": [
      {
        "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": 1,
        "price": "65261.3934196038",
        "priceChange": "-0.543",
        "24hVolume": "32400445942",
        "24hVolumeChange": "1.8503",
        "openInterest": "28281554854.323086",
        "openInterestChange": "-0.7643",
        "fundingRate": "-0.002018022324683528"
      }
    ]
  },
  "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

Global futures statistics. Scope includes all futures coins, not just the current page.
data.stats.total Number

Total number of coins with futures data matching the applied filters.
data.stats.totalCoins Number

Total number of coins with active futures markets.
data.stats.totalMarkets Number

Total number of active futures markets.
data.stats.totalExchanges Number

Total number of exchanges offering futures.
data.stats.totalOpenInterest String

Global open interest in the reference currency.
data.stats.total24hVolume String

Global 24-hour futures trading volume in the reference currency.
data.stats.fundingRate String

Open-interest-weighted average funding rate (8-hour display convention).
data.coins[] Object[]

List of futures coins
data.coins[].uuid String

UUID of the coin.
data.coins[].symbol String

Currency symbol
data.coins[].name String

Name of the coin.
data.coins[].color String

Main HEX color of the coin
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[].rank Number

The position in the ranks
data.coins[].price String

Price of the futures coin
data.coins[].priceChange String

24-hour price change percentage.
data.coins[].24hVolume String

24h trade volume
data.coins[].24hVolumeChange String

24-hour volume change percentage.
data.coins[].openInterest String

Open interest in the reference currency.
data.coins[].openInterestChange String

24-hour open interest change percentage.
data.coins[].fundingRate String

OI-weighted average funding rate for this coin (8-hour display convention). Null when unavailable.
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 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}

Error responses

Previous

Introduction

 Next

Futures coin details

On this page