Get futures coin details

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

Get detailed futures metrics for a single coin. The response includes converted price, volume, open interest, funding rate, and metadata such as description and links.

https://api.coinranking.com/v2/futures/coin/:uuid

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 coin you want to request. UUIDs of coins can be found using the coins endpoint or by checking the URL on coinranking.com.

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

Code examples

curl 'https://api.coinranking.com/v2/futures/coin/Qwsogvtv82FCd?referenceCurrencyUuid=5k-_VTxqtCEI' \
  -H 'x-access-token: your-api-key' \
  -G

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

fetch('https://api.coinranking.com/v2/futures/coin/Qwsogvtv82FCd?referenceCurrencyUuid=5k-_VTxqtCEI', 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/coin/Qwsogvtv82FCd?referenceCurrencyUuid=5k-_VTxqtCEI",
    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/coin/Qwsogvtv82FCd?referenceCurrencyUuid=5k-_VTxqtCEI", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "coin": {
      "id": 1,
      "uuid": "Qwsogvtv82FCd",
      "symbol": "BTC",
      "name": "Bitcoin",
      "description": "Bitcoin is a decentralized digital currency...",
      "links": [
        {
          "name": "website",
          "type": "website",
          "url": "https://bitcoin.org"
        }
      ],
      "color": "#f7931A",
      "iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
      "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
      "priceAt": 1710000000,
      "btcPrice": "1",
      "price": "65261.3934196038",
      "priceChange": "-0.543",
      "24hVolume": "32400445942",
      "24hVolumeChange": "1.8503",
      "openInterest": "28281554854.323086",
      "openInterestChange": "-0.7643",
      "fundingRate": "-0.002018022324683528",
      "numberOfMarkets": 150,
      "numberOfExchanges": 10
    }
  }
}

Response fields

Property	Description
status `String`	Status of the request Allowed values: success
data.coin `Object`	Futures metrics and metadata for the requested coin.
data.coin.id `Number`	Internal numeric identifier of the coin.
data.coin.uuid `String`	UUID of the coin.
data.coin.symbol `String`	Currency symbol.
data.coin.name `String`	Name of the coin.
data.coin.description `String\|null`	Description text of the coin. Returns null when unavailable.
data.coin.links `Object[]`	List of links associated with the coin (website, explorers, social profiles, etc.).
data.coin.color `String`	Main HEX color of the coin.
data.coin.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.coin.coinrankingUrl `String`	Where to find the coin on coinranking.com
data.coin.priceAt `Number\|null`	Epoch timestamp in seconds of the latest futures price update.
data.coin.btcPrice `String\|null`	Price of the coin expressed in Bitcoin.
data.coin.price `String`	Futures price in the reference currency.
data.coin.priceChange `String\|null`	24-hour price change percentage.
data.coin.24hVolume `String`	24-hour trading volume in the reference currency.
data.coin.24hVolumeChange `String\|null`	24-hour volume change percentage.
data.coin.openInterest `String`	Open interest in the reference currency.
data.coin.openInterestChange `String\|null`	24-hour open interest change percentage.
data.coin.fundingRate `String\|null`	OI-weighted average funding rate (8-hour display convention).
data.coin.numberOfMarkets `Number`	Number of active futures markets for this coin.
data.coin.numberOfExchanges `Number`	Number of exchanges with futures markets for this coin.

Error response

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

Error responses

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.

Error	Description
COIN_NOT_FOUND `Object`	The coin could not be found. Try another UUID