GateData.AI

Markets Derivatives Volume History

查询 Crypto 衍生品成交量历史（Gate USDT 永续等）。

GET/api/v1/markets/derivatives/volume-history
Domain
Market & Liquidity
Level
asset-level
MCP tool
market_data_query (task=derivatives_volume_history)

Available data

Query level: asset-level.

  • Input must resolve to one asset (ticker / name).
  • Name multi-match → HTTP 200 with resolution_status=ambiguous and data[] candidates (no silent binding).
  • Resolution priority: object IDs > ticker/name; a bare ticker requires market or venue_id.
  • context.market is for fuzzy disambiguation only — it never overrides an exact ticker or listing_id.

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_btcoptional

Canonical asset identifier

querystringqueryExampleBTCoptional

Search text used to resolve the query object

tickerstringqueryExampleBTCoptional

Ticker alias of query.

symbolstringqueryExampleBTCoptional

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_usdnumber

Open-interest notional in USD

funding_ratenumber

Perpetual contract funding rate

long_short_ratio_top_tradernumber

Top-trader long-short ratio

long_short_ratio_globalnumber

Long-short ratio across all accounts or positions

taker_buy_sell_rationumber

Aggressive buy-to-sell volume ratio

liquidation_24hnumber | null

Liquidation notional over the past 24 hours

options_oi_usdnumber

Options open-interest notional in USD

options_volume_24h_usdnumber

Options traded notional over the past 24 hours

snapshot_timedatetime

Source snapshot time for the order book or model

data_statusDataStatus

Availability of the business data

metadataobject

Response status and resolution information

missing_fields[]string[]

Contract fields omitted from the response

data_statusDataStatusExamplenot_ready

Availability of the business data

limitations[]string[]Exampledata_not_ready

Known data limitations

updated_atdatetime | string

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

typeObjectRefType

Object reference type

idstring

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_idstring

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.