# Crypto Derivatives Markets API

> Crypto Derivatives Markets API is a paid API for AI agents from crypto.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns live derivatives market data (futures/perps) ranked by open interest, with optional filtering by coin symbol and result limit

## Facts

- Endpoint: POST https://crypto.openverbs.com/v1/derivatives?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-derivatives-markets-api-4f669d41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4GiW22yeNoIEL1lguyweN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability crypto-derivatives-markets-api-4f669d41 -d '<json body>'
```

Example prompt: Pull the top 20 crypto derivatives markets ranked by open interest, filtering for just BTC, ETH, and SOL.

## When to prefer this

Use this endpoint when you need live derivatives market data ranked by open interest and want to filter by specific cryptocurrencies. Prefer this over spot price endpoints when the user's question is about futures, perpetuals, or open interest rather than token spot prices. Ideal for traders, analysts, or agents monitoring derivatives activity or building dashboards around futures market size.

## Known failure modes

- Invalid coin symbol in the coins array returns an error or empty results for that symbol
- Limit exceeding 250 is rejected with a validation error
- Empty coins array with no matching markets returns an empty result set
- Network or upstream data provider outage causes delayed or unavailable market data
- Malformed request body causes a 400 bad request error

## How this service works

Crypto perpetual-futures data from on-chain perp DEXs: per market the funding rate (hourly + annualized %), open interest (USD and base units), mark & oracle price, 24h volume and 24h price change. Ranked by open interest; filter by `coins` or `limit`. Data source: Hyperliquid (dYdX fallback).

## Output

A ranked list of derivatives markets (futures/perpetuals) sorted by open interest, optionally filtered to specified coin symbols, up to the requested limit. Each market entry likely includes the coin symbol, contract type, open interest value, and exchange or venue details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coins": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 20,
    "minLength": 1
   },
   "maxItems": 50,
   "description": "Optional filter — symbols to include, e.g. [\"BTC\",\"ETH\",\"SOL\"]. Omit for the full market."
  },
  "limit": {
   "type": "integer",
   "maximum": 250,
   "minimum": 1,
   "description": "How many markets to return, ranked by open interest (default 30)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-derivatives-markets-api-4f669d41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.openverbs.com](https://www.zero.xyz/host/crypto.openverbs.com/llms.txt)
