Markets Derivatives Volume History
查询 Crypto 衍生品成交量历史（Gate USDT 永续等）。
GET/api/v1/markets/derivatives/volume-history
可查询数据
查询层级：asset-level。
- 输入需解析到唯一 asset（ticker / name）。
- 名称多命中 → HTTP 200 + resolution_status=ambiguous + data[] 候选（禁止静默绑定）。
- 解析优先级：对象 ID > ticker/名称；独立 ticker 须带 market 或 venue_id。
- context.market 仅模糊消歧，不覆盖精确 ticker 或 listing_id。
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
资产定位
至少填写一项：asset_id / query / ticker / symbol。
asset_idstringquery示例asset_btc可选资产标识，标识股票、加密资产等资产对象
querystringquery示例BTC可选用于解析查询对象的检索词
tickerstringquery示例BTC可选query 的 ticker 别名。
symbolstringquery示例BTC可选query 的 symbol 别名。
时间范围
建议 start_time 与 end_time 成对。
start_timedatetimequery示例2026-07-01T00:00:00Z可选查询时间范围起点
end_timedatetimequery示例2026-07-31T23:59:59Z可选查询时间范围终点
响应
open_interest_usdnumber未平仓合约美元名义价值
funding_ratenumber永续合约资金费率
long_short_ratio_top_tradernumber头部交易者多空比
long_short_ratio_globalnumber全体账户或持仓多空比
taker_buy_sell_rationumber主动买卖成交量比
liquidation_24hnumber | null过去24小时清算金额
options_oi_usdnumber期权未平仓美元名义价值
options_volume_24h_usdnumber24小时期权成交额
snapshot_timedatetime盘口或模型的源快照时间
data_statusDataStatus业务数据可用状态
metadataobject
响应状态与解析信息容器
missing_fields[]string[]未返回的合同字段数组
业务数据可用状态
limitations[]string[]示例data_not_ready已知数据限制数组
updated_atdatetime | string对象或响应最近更新时间
partialboolean响应是否仅含部分字段
resolution_reasonstring对象解析结果的原因码
object_refs[]object[]
统一对象引用数组
typeObjectRefType对象引用类型
idstring对象标识，标识 type 指定的具体对象
entity_idstring主体标识，标识公司、项目方或协议等主体
asset_idstring资产标识，标识股票、加密资产等资产对象
listing_idstring交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录
instrument_idstring交易工具标识，标识股票、现货交易对或合约等具体交易产品
venue_idstring交易场所标识，标识交易所或交易平台
event_refstring关联事件标识，标识与当前对象关联的事件
market_idstring预测市场标识，标识预测事件下的具体市场
venuestring对象关联的平台代码
resolved_fromstring对象解析所用输入来源
resolution_confidencestring对象解析置信度
错误与降级
200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。