Derivatives metrics

Query perpetual funding rates, USD open interest, long-short ratios, and liquidation time series by asset and venue.

GET/api/v1/markets/derivatives
Domain
Market & Liquidity
Level
Crypto asset
MCP tool
market_data_query (task=derivatives)

Available data

Returns
Query perpetual funding rates, USD open interest, long-short ratios, and liquidation time series by asset and venue
What each request returns
Returns an items[] time series. Default BTC uses the hourly series, not a single snapshot. Per-row missing_fields and limitations explain unavailable fields. Gate uses a separate 5m source.

Authentication

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

Query Parameters

Asset identification

Provide at least one of query, ticker, symbol or asset_id

querystringqueryoptional

Asset name or ticker, e.g. BTC

tickerstringqueryoptional

Alias of query

symbolstringqueryoptional

Alias of query

asset_idstringqueryoptional

Canonical asset identifier

Market filter
marketstringqueryoptional

Market code; derivatives currently serve crypto only

venuestringqueryExamplebinanceoptional

Exchange; default binance. Gate uses live 5-minute contract statistics; other venues use the CoinGlass hourly series. · Default: binance

market_typestringqueryoptional

Only perp is supported; spot and futures return invalid_parameter. · perp

Time range and output
start_timestringqueryoptional

Inclusive UTC start; RFC3339, date or Unix seconds. Alias: from

end_timestringqueryoptional

Exclusive UTC end; a date-only value includes that UTC day. Alias: to

fromstringqueryoptional

Alias of start_time

tostringqueryoptional

Alias of end_time

intervalstringqueryoptional

Gate always uses 5m; other venues serve the 1h series

timeframestringqueryoptional

Alias of interval

limitintegerqueryoptional

Gate: default 288, maximum 2000. Other venues: latest N hourly points; omit for the requested window. · Default: 288 · ≤ 2000

orderstringqueryoptional

Hourly-series order; default asc. · asc / desc

Response

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Business data availability status

countintegerExample168

Returned snapshot count, when present

limitations[]string[]Examplederivatives_3rd_parties

Known data limitations

updated_atdatetime | stringExample2026-11-16T05:10:15Z

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

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstring

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

listing_idstring

Canonical listing identifier

instrument_idstring

Canonical financial instrument identifier

venue_idstring

Canonical trading venue identifier

event_refstring

Related event identifier

market_idstring

Canonical market object identifier

venuestring

Related platform code

resolved_fromstringExampleasset_entity

Input used to resolve the object

resolution_confidencestringExampleresolved

Object resolution confidence

asset_idstringExampleasset_btc

Asset identifier

venuestringExamplebinance

Selected venue; defaults to binance

contractstring

Gate contract code, when returned

market_typeMarketType

Perpetual contract type, when returned: perp

intervalstringExample1h

5m for Gate statistics; 1h for third-party snapshots

start_timedatetimeExample2026-11-09T06:00:00Z

Response time-range start

end_timedatetimeExample2026-11-16T06:00:00Z

Response time-range end

total_countintegerExample168

Count reported by this response; not a guaranteed full-history total

has_morebooleanExamplefalse

Whether additional snapshots are available; inspect separately from next_cursor

next_cursorstring | null

Pagination cursor; may be null even when has_more is true

items[]array[object]

Derivative metric snapshots

open_interest_usdnumber | nullExample10557765600

Open interest notional in USD

funding_ratenumber | nullExample0.0001

Decimal funding rate; 0.0001 equals 0.01%. Already normalized; do not divide by 100 again

long_short_ratio_globalnumber | nullExample2.79

Global long/short ratio

long_short_ratio_top_tradernumber | nullExample3.06

Top-trader long/short ratio

taker_buy_sell_rationumber | nullExample0.9402405599999999

Taker buy/sell ratio

liquidation_24hnumber | nullExample120322205.13

Liquidation notional in USD; Gate derives this from the current 5-minute contract-stat interval, not a rolling 24-hour sum

options_oi_usdnumber | nullExample1484064260

Options open interest in USD, when available; not returned by Gate contract statistics

options_volume_24h_usdnumber | null

24-hour options volume in USD; unavailable values may be null

snapshot_timedatetimeExample2026-11-09T06:00:00Z

Source period time; distinct from metadata.updated_at

data_statusDataStatusExampleready

Snapshot availability status

metadataobject

Per-snapshot metadata

updated_atdatetimeExample2026-11-09T06:10:12Z

Source update time

limitations[]string[]Examplemissing_fields

derivatives_3rd_parties marks third-party snapshots; missing_fields marks unavailable fields

missing_fields[]string[]Exampleoptions_volume_24h_usd

Names of unavailable fields; null does not mean zero

data_statusDataStatusExampleready

Overall availability status

request_idstringExamplef964d9bd-2a44-40fd-b2b7-1c93fe5c5388

Request identifier

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.