Skip to main content
GET
/
derivatives
Derivatives Tickers List
curl --request GET \
  --url https://api.coingecko.com/api/v3/derivatives \
  --header 'x-cg-demo-api-key: <api-key>'
[
  {
    "market": "Binance (Futures)",
    "symbol": "BTCUSDT",
    "index_id": "BTC",
    "price": "77034.8",
    "price_percentage_change_24h": -1.1733397846861013,
    "contract_type": "perpetual",
    "index": 76691.4276087,
    "basis": -0.138769748300737,
    "spread": 0.01,
    "funding_rate": 0.004308,
    "open_interest": 7497508223.83,
    "volume_24h": 9623150393.3656,
    "last_traded_at": 1779807819,
    "expired_at": null
  },
  {
    "market": "Binance (Futures)",
    "symbol": "ETHUSDT",
    "index_id": "ETH",
    "price": "2113.92",
    "price_percentage_change_24h": -1.213464572845443,
    "contract_type": "perpetual",
    "index": 2099.55744186,
    "basis": -0.19217332857957786,
    "spread": 0.01,
    "funding_rate": 0.005327,
    "open_interest": 4563725156.36,
    "volume_24h": 7655835901.46112,
    "last_traded_at": 1779807818,
    "expired_at": null
  }
]
open_interest and volume_24h values in the response are in USD.

​
SDK Examples

const response = await client.derivatives.get();

console.log(JSON.stringify(response, null, 2));

Authorizations

​
x-cg-demo-api-key
string
header
required

Response

200 - application/json

List of derivative tickers

​
market
string
required

Derivative market name

​
symbol
string
required

Derivative ticker symbol

​
index_id
string
required

Derivative underlying asset

​
price
string
required

Derivative ticker price

​
price_percentage_change_24h
number
required

Derivative ticker price percentage change in 24 hours

​
contract_type
string
required

Derivative contract type

​
index
number
required

Derivative underlying asset price

​
basis
number
required

Difference of derivative price and index price

​
spread
number
required

Derivative bid-ask spread

​
funding_rate
number
required

Derivative funding rate

​
open_interest
number
required

Derivative open interest

​
volume_24h
number
required

Derivative trading volume in 24 hours

​
last_traded_at
number
required

Derivative last traded time in UNIX timestamp

​
expired_at
number | null
required

Derivative expiry time in UNIX timestamp