Derivative pairs

GET https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs

The perpetual and futures contracts of one crypto asset, or of one exchange, with price, volume, funding rate, open interest and basis.

Coverage. Only the derivatives exchanges we collect, and only contracts whose base asset is an asset on /assets. The list is refreshed once an hour, and each row's data_time is the hour of the refresh it comes from. An exchange whose latest refresh failed keeps its previous rows, so its data_time is older. A futures contract leaves the list at its expiration, and one without an expiration date is not listed.

Query parameters

idintegerThe asset id from /assets. Exactly one of id and exchange_id
exchange_idintegerAn exchange id, as /exchanges and /derivatives/exchanges publish it
categorystringDefaultbothperpetual or futures
page, size, limit, offsetintegerDefaultsize 20As on /assets
sortstringDefaultvolume_24h:descvolume_24h, open_interest_usd, funding_rate, written <key>[:asc|desc]; a key with no direction is ascending. A null sorts last descending and first ascending. Equal values keep a fixed order

Response

Item fields

Field	Type	Notes
`exchange`	object	`{id, name, slug, logo}`; `id` is the `/exchanges` id, `logo` an empty string when there is none. Present whichever of `id` and `exchange_id` you asked by
`base`	object	`{id, symbol, name, slug}`; `id` is the `/assets` id. Present either way too
`pair`	string	Such as `BTC/USDT`
`quote_symbol`	string
`category`	string	`perpetual` or `futures`
`price`	string
`volume_24h`	string	24h volume in USD
`volume_percent`	string	This contract's share of the 24h volume of every contract your request matched — across all pages, not only this one — as a percentage: `"31.52"` is 31.52%. `"0"` when the matched volume is zero
`index_price`	string or `null`	`null` when the exchange reports none, or reports 0
`funding_rate`	string or `null`	`null` for futures
`open_interest_usd`	string or `null`	Some exchanges report a contract's open interest as a quantity of the asset rather than in USD; we pass the value on as reported
`index_basis`	string or `null`
`expiration_time`	string or `null`	When a futures contract expires, RFC3339 UTC; `null` for perpetuals
`data_time`	string	The hour of the refresh this row comes from, RFC3339 UTC — always on the hour

Examples

bash

# Bitcoin's perpetuals, biggest volume first
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?id=1&category=perpetual"

# One exchange's contracts, by open interest
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?exchange_id=42&sort=open_interest_usd:desc&limit=50"

HTTP status	`code`	When
400	40000	Both or neither of `id` and `exchange_id`; either not a positive integer (one value, not a list); a `category` other than `perpetual` and `futures`; a `sort` key outside the three above, or a malformed `sort`; the paging limits of `/assets`

An id or exchange_id with no contracts — one that does not exist, an RWA's id, an exchange we do not collect — is an empty page, not a 404. The other errors are in Errors.

# Bitcoin's perpetuals, biggest volume first import requests response = requests.get( "https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?id=1&category=perpetual", headers={"X-Api-Key": "<your-api-key>"}, ) print(response.json())

// Bitcoin's perpetuals, biggest volume first fetch("https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?id=1&category=perpetual", { headers: { "X-Api-Key": "<your-api-key>" }, }) .then((response) => response.json()) .then((body) => console.log(body));

// Bitcoin's perpetuals, biggest volume first package main import ( "fmt" "io" "net/http" ) func main() { req, err := http.NewRequest(http.MethodGet, "https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?id=1&category=perpetual", nil) if err != nil { panic(err) } req.Header.Set("X-Api-Key", "<your-api-key>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

// Bitcoin's perpetuals, biggest volume first import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder(URI.create("https://open-api.coinworldcap.com/openapi/v1/derivatives/pairs?id=1&category=perpetual")) .header("X-Api-Key", "<your-api-key>") .GET() .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

{ "code": 0, "message": "success", "message_key": "SUCCESS", "result": { "items": [ { "exchange": { "id": 42, "name": "Binance", "slug": "binance", "logo": "https://s2.coinmarketcap.com/static/img/exchanges/64x64/270.png" }, "base": { "id": 1, "symbol": "BTC", "name": "Bitcoin", "slug": "bitcoin" }, "pair": "BTC/USDT", "quote_symbol": "USDT", "category": "perpetual", "price": "67210.5", "volume_24h": "12345678901.23", "volume_percent": "31.52", "index_price": "67205.1", "funding_rate": "0.0001", "open_interest_usd": "8765432109.87", "index_basis": "0.00008", "expiration_time": null, "data_time": "2026-10-27T08:00:00Z" } ], "page": 1, "total_page": 3, "total": 52 } }