# Agent402 Options Volume by Protocol

> Agent402 Options Volume by Protocol is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns DeFi options trading volume data across protocols and chains, including 24h, 7d, and 30d volume figures with percentage changes.

## Facts

- Endpoint: POST https://agent402.tools/api/options-volume
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-options-volume-by-protocol-11feb697
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IonUJXLiBYvSE5xh_-sW-

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 agent402-options-volume-by-protocol-11feb697 -d '<json body>'
```

Example prompt: What are the top 10 DeFi options protocols by trading volume right now, filtered to Arbitrum?

## When to prefer this

Use this endpoint when you need structured, multi-period options trading volume data across DeFi protocols — especially when you want chain-level filtering (e.g. only Arbitrum or Base) or ranked protocol lists. Prefer it over general DeFi data APIs when options-specific volume metrics (24h/7d/30d) and change percentages are the primary need. It is more targeted than a broad DeFi analytics query and cheaper than a full DefiLlama API integration.

## Known failure modes

- Invalid chain name returns empty protocol list or zero results
- Limit exceeding 100 is clamped or returns an error
- Data may lag real-time by the DefiLlama refresh interval
- Malformed request body returns a 400-level error
- Network or upstream DefiLlama outage causes fetch failure

## How this service works

Onchain options protocols ranked by 24h notional volume with 7d and 30d volume, 1d and 7d change and the chains each runs on, plus sector totals. Use it when an agent is comparing decentralized options venues or tracking whether onchain options activity is growing.

## Output

A JSON object containing the total count of protocols returned, a list of active chains, the data source (DefiLlama), aggregate volume totals (24h, 7d, 30d USD) with 1d and 7d percentage changes, the fetch timestamp, and an array of individual protocol records each with name, slug, chains, category, and volume metrics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Optional chain name filter, e.g. Arbitrum (case-insensitive)."
  },
  "limit": {
   "type": "number",
   "description": "Protocols to return (default 25, max 100)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "chains": [
   "Derive Chain",
   "Hyperliquid L1",
   "Base"
  ],
  "source": "defillama-options",
  "totals": {
   "change1dPct": 10.03,
   "change7dPct": 4.1,
   "volume7dUsd": 11148265.31,
   "volume24hUsd": 5093016,
   "volume30dUsd": 30971390.66
  },
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "protocols": [
   {
    "name": "Derive",
    "slug": "derive",
    "chains": [
     "Derive Chain"
    ],
    "category": "Options",
    "change1dPct": 12.5,
    "change7dPct": 3.2,
    "volume7dUsd": 7000000,
    "volume24hUsd": 3000000,
    "volume30dUsd": 20000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-options-volume-by-protocol-11feb697/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)