GateData.AI

Derivatives metrics

Query derivatives-market metrics for an asset, including funding rate, open interest, basis, and long-short ratio.

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

Available data

Returns
Derivatives-market metrics for an asset, including funding rate, open interest, basis, and long-short ratio
Market coverage
Crypto derivatives markets
Query granularity
One asset per query; the response aggregates applicable derivatives markets rather than one contract trade stream

Authentication

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

Query Parameters

Asset positioning

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

asset_idstringqueryExampleasset_btcconditional

Canonical asset identifier

querystringqueryExampleBTCconditional

Search text used to resolve the query object

tickerstringqueryExampleBTCconditional

Ticker alias of query.

symbolstringqueryExampleBTCconditional

Symbol alias of query.

Market filter

Optional.

marketMarketqueryExamplecryptooptional

Market of the query object

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

open_interest_usdnumberExample47700599880

Open-interest notional in USD

funding_ratenumberExample0.006401617876131179

Perpetual contract funding rate

long_short_ratio_top_tradernumberExample1.4988504061814978

Top-trader long-short ratio

long_short_ratio_globalnumberExample1.4988504061814978

Long-short ratio across all accounts or positions

taker_buy_sell_rationumberExample1.0608364723728847

Aggressive buy-to-sell volume ratio

liquidation_24hnumber | nullExample109064634278.63004

Liquidation notional over the past 24 hours

options_oi_usdnumberExample26210658500

Options open-interest notional in USD

options_volume_24h_usdnumberExample95450937

Options traded notional over the past 24 hours

snapshot_timedatetimeExample2026-08-17T16:10:21Z

Source snapshot time for the order book or model

data_statusDataStatusExampleready

Availability of the business data

metadataobject

Response status and resolution information

missing_fields[]string[]

Contract fields omitted from the response

data_statusDataStatusExampleready

Availability of the business data

limitations[]string[]

Known data limitations

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

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

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.