GateData.AI

Per-exchange derivatives

Query historical derivatives volume, open interest, market counts, and fees by centralized exchange.

GET/api/v1/markets/cex-derivatives
Domain
Market & Liquidity
Level
Centralized exchange
MCP tool
market_data_query (task=cex_derivatives)

Available data

Returns
Historical derivatives volume, open interest, market counts, and fees by centralized exchange
Market coverage
Major centralized exchanges
Query granularity
Each row is an exchange-level aggregate; a venue filter selects one exchange, otherwise the response lists exchanges up to the requested limit

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Venue filter

Optional.

venuestringqueryExamplebinanceoptional

Trading venue code to query

Response control

Optional.

periodstringqueryExample24hoptional

Metric aggregation period

limitintegerqueryExample20optional

Maximum records returned per request

Time range

Prefer start_time with end_time.

start_timedatetimequeryExample2026-07-01T00:00:00Zoptional

Start of the query time range

end_timedatetimequeryExample2026-07-31T23:59:59Zoptional

End of the query time range

Response

items[]array[object (CexDerivativesItem)]

Business records

exchange_slugstringExamplebinance

Canonical exchange short code

exchange_namestringExampleBinance

Exchange or platform name

venue_idstringExamplevenue_binance

Canonical trading venue identifier

exchange_scorenumber | nullExample10

Composite exchange score

derivatives_market_pairsnumber | nullExample766

Number of derivatives trading pairs

spot_volume_24hnumber | nullExample4763616800

Spot volume over the past 24 hours

total_volume_24hnumber | nullExample42229395000

Total volume over the past 24 hours

volume_perps_24hnumberExample37465780000

Perpetual contract volume over the past 24 hours

derivatives_volume_24h_usdnumberExample37465780000

Derivatives traded notional over the past 24 hours

open_interest_usdnumber | nullExample27319472100

Open interest notional in USD

derivatives_open_interestsnumber | nullExample27319472100

Aggregated derivatives open interest

maker_feenumber | nullExample0.02

Base maker fee rate

taker_feenumber | nullExample0.04

Base taker fee rate

periodstringExample24h

Metric aggregation period

snapshot_timedatetimeExample2026-08-17T15:02:21Z

Source snapshot time for the metrics

last_updateddatetime | stringExample2026-08-17T15:02:21Z

Most recent update time for this record

data_statusDataStatusExampleready

Availability of this business record

data_statusDataStatusExampleready

Availability of the business data

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Availability of the business data

missing_fields[]string[]

Contract fields omitted from the response

actual_taskstring

Task that was actually executed

route_reasonstring

Reason the task or object was selected

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:22Z

Most recent object or response update time

partialboolean

Whether the response contains only a subset of fields

resolution_reasonstring

Reason code for the object-resolution outcome

object_refs[]object[]

Unified object references

typeObjectRefTypeExamplevenue

Object reference type

idstringExamplevenue_binance

Canonical object identifier

entity_idstring

Canonical entity identifier

asset_idstring

Canonical asset identifier

listing_idstring

Canonical listing identifier

instrument_idstring

Canonical financial instrument identifier

venue_idstringExamplevenue_binance

Canonical trading venue identifier

event_refstring

Related event identifier

market_idstring

Canonical market object identifier

venuestring

Related platform code

resolved_fromstring

Input used to resolve the object

resolution_confidencestring

Object resolution confidence

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.