Get futures coin details
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
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
Response
jsonHTTP/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 |
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
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next