Derivatives metrics
Query perpetual funding rates, USD open interest, long-short ratios, and liquidation time series by asset and venue.
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
Query Parameters
Provide at least one of query, ticker, symbol or asset_id
querystringqueryoptionalAsset name or ticker, e.g. BTC
tickerstringqueryoptionalAlias of query
symbolstringqueryoptionalAlias of query
asset_idstringqueryoptionalCanonical asset identifier
marketstringqueryoptionalMarket code; derivatives currently serve crypto only
venuestringqueryExamplebinanceoptionalExchange; default binance. Gate uses live 5-minute contract statistics; other venues use the CoinGlass hourly series. · Default: binance
market_typestringqueryoptionalOnly perp is supported; spot and futures return invalid_parameter. · perp
start_timestringqueryoptionalInclusive UTC start; RFC3339, date or Unix seconds. Alias: from
end_timestringqueryoptionalExclusive UTC end; a date-only value includes that UTC day. Alias: to
fromstringqueryoptionalAlias of start_time
tostringqueryoptionalAlias of end_time
intervalstringqueryoptionalGate always uses 5m; other venues serve the 1h series
timeframestringqueryoptionalAlias of interval
limitintegerqueryoptionalGate: default 288, maximum 2000. Other venues: latest N hourly points; omit for the requested window. · Default: 288 · ≤ 2000
orderstringqueryoptionalHourly-series order; default asc. · asc / desc
Response
Response status and resolution information
Business data availability status
countintegerExample168Returned snapshot count, when present
limitations[]string[]Examplederivatives_3rd_partiesKnown data limitations
updated_atdatetime | stringExample2026-11-16T05:10:15ZMost recent object or response update time
partialbooleanWhether the response contains only a subset of fields
resolution_reasonstringReason code for the object-resolution outcome
Unified object references
Object reference type
idstringExampleasset_btcCanonical object identifier
entity_idstringCanonical entity identifier
asset_idstringExampleasset_btcCanonical asset identifier
listing_idstringCanonical listing identifier
instrument_idstringCanonical financial instrument identifier
venue_idstringCanonical trading venue identifier
event_refstringRelated event identifier
market_idstringCanonical market object identifier
venuestringRelated platform code
resolved_fromstringExampleasset_entityInput used to resolve the object
resolution_confidencestringExampleresolvedObject resolution confidence
asset_idstringExampleasset_btcAsset identifier
venuestringExamplebinanceSelected venue; defaults to binance
contractstringGate contract code, when returned
market_typeMarketTypePerpetual contract type, when returned: perp
intervalstringExample1h5m for Gate statistics; 1h for third-party snapshots
start_timedatetimeExample2026-11-09T06:00:00ZResponse time-range start
end_timedatetimeExample2026-11-16T06:00:00ZResponse time-range end
total_countintegerExample168Count reported by this response; not a guaranteed full-history total
has_morebooleanExamplefalseWhether additional snapshots are available; inspect separately from next_cursor
next_cursorstring | nullPagination cursor; may be null even when has_more is true
Derivative metric snapshots
open_interest_usdnumber | nullExample10557765600Open interest notional in USD
funding_ratenumber | nullExample0.0001Decimal funding rate; 0.0001 equals 0.01%. Already normalized; do not divide by 100 again
long_short_ratio_globalnumber | nullExample2.79Global long/short ratio
long_short_ratio_top_tradernumber | nullExample3.06Top-trader long/short ratio
taker_buy_sell_rationumber | nullExample0.9402405599999999Taker buy/sell ratio
liquidation_24hnumber | nullExample120322205.13Liquidation notional in USD; Gate derives this from the current 5-minute contract-stat interval, not a rolling 24-hour sum
options_oi_usdnumber | nullExample1484064260Options open interest in USD, when available; not returned by Gate contract statistics
options_volume_24h_usdnumber | null24-hour options volume in USD; unavailable values may be null
snapshot_timedatetimeExample2026-11-09T06:00:00ZSource period time; distinct from metadata.updated_at
Snapshot availability status
Per-snapshot metadata
updated_atdatetimeExample2026-11-09T06:10:12ZSource update time
limitations[]string[]Examplemissing_fieldsderivatives_3rd_parties marks third-party snapshots; missing_fields marks unavailable fields
missing_fields[]string[]Exampleoptions_volume_24h_usdNames of unavailable fields; null does not mean zero
Overall availability status
request_idstringExamplef964d9bd-2a44-40fd-b2b7-1c93fe5c5388Request identifier