# DefiLlama Options Volumes

> DefiLlama Options Volumes is a paid API for AI agents from defillama.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns options protocol volume summaries across all tracked DeFi options protocols, including daily premium and notional volume data.

## Facts

- Endpoint: GET https://defillama.use.x402atlas.com/options
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-options-volumes-85e1269d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xGXpHPZPRye3OC_WILXZ0

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 defillama-options-volumes-85e1269d
```

Example prompt: Pull the options volume data from DefiLlama for all protocols — I want to see daily premium volume and notional volume, but skip the aggregate chart breakdown to keep the response clean.

## When to prefer this

Use this endpoint when you need a comprehensive view of options trading activity across all DeFi options protocols, specifically for premium or notional volume metrics. Prefer this over DEX volume endpoints when the user's question is specifically about options derivatives rather than spot trading.

## Known failure modes

- Invalid dataType parameter returns error or empty result
- Network timeout from upstream DefiLlama API
- Payment not processed results in 402 response
- Malformed query parameter values may be silently ignored or cause 400 error

## How this service works

Options volumes by DefiLlama — all options protocols with premium/notional volume summaries.

## Output

A structured response containing all tracked DeFi options protocols with their volume summaries, including daily premium volume and daily notional volume time series, plus optional aggregate chart data and per-protocol breakdowns depending on query parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "dataType": {
       "type": "string",
       "maxLength": 200,
       "description": "Optional data type (e.g. dailyPremiumVolume, dailyNotionalVolume)"
      },
      "excludeTotalDataChart": {
       "type": "string",
       "maxLength": 200,
       "description": "Optional true/false to exclude the aggregate data chart"
      },
      "excludeTotalDataChartBreakdown": {
       "type": "string",
       "maxLength": 200,
       "description": "Optional true/false to exclude the per-protocol chart breakdown"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "total24h": {
         "type": "number",
         "description": "Aggregate 24h volume in USD, per dataType"
        },
        "protocols": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "name": {
            "type": "string"
           },
           "total24h": {
            "type": "number"
           }
          }
         }
        }
       },
       "description": "Raw DefiLlama options overview payload",
       "additionalProperties": true
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "When this bridge fetched the upstream data"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "total24h": 123000000,
   "protocols": [
    {
     "name": "Lyra",
     "total24h": 1200000
    }
   ]
  },
  "queried_at": "2026-07-01T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-options-volumes-85e1269d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defillama.use.x402atlas.com](https://www.zero.xyz/host/defillama.use.x402atlas.com/llms.txt)