Perp DEX overview

Query protocol-level Perp DEX volume and open-interest snapshots.

GET/api/v1/markets/dex-derivatives

Domain

Market & Liquidity

Level

Perp DEX protocol

MCP tool

market_data_query (task=dex_derivatives)

Available data

Returns: Protocol-level Perp DEX volume and open-interest snapshots
Market coverage: Perpetual-contract DEX protocols across supported chains
Query granularity: Each row is one protocol snapshot; chain filters protocols and sort_by controls ranking

Authentication

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

Query Parameters

Query options

All optional.

chainstringqueryExampleArbitrumoptional

Filter by protocol chain.

sort_bystringqueryExampleopen_interestoptional

Sort field: volume_24h or open_interest.

orderstringqueryExampledescoptional

Sort order: asc or desc; defaults to desc.

limitintegerqueryExample20optional

Rows to return; defaults to 100, maximum 500.

Response

data[]object[]

Perp DEX protocol snapshots

defillama_idstringExample7194

DefiLlama protocol ID

namestringExampleVariational

Protocol name

slugstringExamplevariational

Protocol slug

chains[]string[]ExampleArbitrum

Protocol chains

volume_24hnumberExample1840599187

Trading volume over the past 24 hours (USD)

volume_48hto24hnumberExample2133085145

Trading volume in the preceding 24-hour window (USD)

volume_7dnumberExample10867671631

Cumulative 7-day trading volume (USD)

volume_30dnumberExample40272754427

Cumulative 30-day trading volume (USD)

volume_change_1dnumberExample-13.71

One-day volume change (%)

volume_change_7dnumberExample30.46

Seven-day volume change (%)

open_interestnumberExample863110531

Current open interest (USD)

open_interest_change_1dnumberExample1.47

One-day open-interest change (%)

data_statusDataStatusExampleready

Data availability status

updated_atintegerExample1789711200

Data update time (Unix seconds)

metadataobject

Count, status, limitations, and update time

countintegerExample14

Number of returned protocols

data_statusDataStatusExampleready

Availability status in metadata

limitations[]string[]

Data limitations

updated_atdatetimeExample2026-09-18T06:00:00Z

Metadata update time

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.