Get futures exchanges

Professional This endpoint requires the professional plan or higher

Get a list of futures exchanges with aggregate statistics and a paginated ranking. On Coinranking, we use this endpoint on our Futures exchanges ranking table.

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

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

UUIDs to filter the list on. If you know which exchanges you want, use this filter to return only those entries.

Example:
https://api.coinranking.com/v2/futures/exchanges?uuids[]=Ls9K5HaGJpOI&uuids[]=-zdvbieRdZ
search (optional) String

Filter exchanges by name prefix.

Example:
https://api.coinranking.com/v2/futures/exchanges?search=binance
orderBy (optional) String

Index to order the list by.

Default value: openInterest
Allowed values:
openInterest 24hVolume numberOfMarkets numberOfCoins lastTickerCreatedAt

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

Offset. Used for pagination.

Default value: 0

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

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 10,
      "24hVolume": "33710029708.55014",
      "openInterest": "17321368464.034107"
    },
    "exchanges": [
      {
        "uuid": "-zdvbieRdZ",
        "rank": 1,
        "name": "Binance",
        "iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
        "lastTickerCreatedAt": 1781757395,
        "marketShare": "29.83",
        "coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
        "numberOfMarkets": 395,
        "numberOfCoins": 360,
        "recommended": true,
        "exchangeType": "Centralized",
        "24hVolume": "41105887832",
        "openInterest": "17717491955.63013"
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "nextCursor": null,
    "previousCursor": null
  }
}

Response fields

Property Description
status String

Status of the request.

Allowed values:
success
data.stats Object

Aggregate statistics across all futures exchanges (not just the current page).
data.stats.total Number

Total number of exchanges.
data.stats.24hVolume String

Total 24h volume of exchanges in the reference currency.
data.stats.openInterest String

Aggregate open interest across all matching exchanges, in the reference currency.
data.exchanges Object[]

List of futures exchanges.
data.exchanges.uuid String

UUID of the exchange.
data.exchanges.rank Number

Position in the ranked list for the selected ordering.
data.exchanges.name String

Name of the exchange.
data.exchanges.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.exchanges.lastTickerCreatedAt Number|null

Unix timestamp (seconds) when this exchange last produced a futures ticker in our dataset.
data.exchanges.marketShare String|null

Percentage of the total exchange volume represented by this exchange.
data.exchanges.coinrankingUrl String

Where to find the exchange on coinranking.com.
data.exchanges.exchangeType String

Type of exchange.

Allowed values:
Centralized Decentralized Unknown
data.exchanges.24hVolume String

24-hour trading volume in the reference currency.
data.exchanges.openInterest String

Open interest in the reference currency.
data.exchanges.numberOfMarkets Number

Number of futures markets of the exchange paired with Coinranking.
data.exchanges.numberOfCoins Number

Number of futures coins of the exchange paired with Coinranking.
data.exchanges.recommended Boolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges.
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 not available"
}

Error responses

Previous

Futures coin OHLCV

 Next

Futures exchange coins

On this page