GateData.AI

Perp DEX 概览

查询 Perp DEX 协议的交易量与未平仓量快照。

GET/api/v1/markets/dex-derivatives
数据域
行情与流动性
解析层级
Perp DEX 协议
MCP 工具
market_data_query (task=dex_derivatives)

可查询数据

返回数据
Perp DEX 协议的交易量与未平仓量快照
市场覆盖
已支持链上的永续合约 DEX 协议
查询粒度
每条记录对应一个协议快照；chain 用于筛选协议，sort_by 用于排序

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

查询条件

均为可选。

chainstringquery示例Arbitrum可选

按协议所在链筛选。

sort_bystringquery示例open_interest可选

排序字段：volume_24h 或 open_interest。

orderstringquery示例desc可选

排序方向：asc 或 desc，默认 desc。

limitintegerquery示例20可选

返回数量，默认 100，最大 500。

响应

data[]object[]

Perp DEX 协议快照列表

defillama_idstring示例7194

DefiLlama 协议 ID

namestring示例Variational

协议名称

slugstring示例variational

协议 slug

chains[]string[]示例Arbitrum

协议所在链

volume_24hnumber示例1840599187

最近 24 小时交易量（USD）

volume_48hto24hnumber示例2133085145

前一个 24 小时交易量（USD）

volume_7dnumber示例10867671631

最近 7 天累计交易量（USD）

volume_30dnumber示例40272754427

最近 30 天累计交易量（USD）

volume_change_1dnumber示例-13.71

1 天交易量变化率（%）

volume_change_7dnumber示例30.46

7 天交易量变化率（%）

open_interestnumber示例863110531

当前未平仓量（USD）

open_interest_change_1dnumber示例1.47

过去一天未平仓量变化率（%）

data_statusDataStatus示例ready

数据可用状态

updated_atinteger示例1789711200

数据更新时间（Unix 秒）

metadataobject

数量、状态、限制与更新时间

countinteger示例14

返回协议数量

data_statusDataStatus示例ready

元数据中的可用状态

limitations[]string[]

数据限制说明

updated_atdatetime示例2026-09-18T06:00:00Z

元数据更新时间

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。