# Beggar Bot /v1/ivsmile – Implied Volatility Smile Lookup

> Beggar Bot /v1/ivsmile – Implied Volatility Smile Lookup is a paid API for AI agents from beggar-bot-demand.beggarbot.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-10).

Fetches implied volatility smile data for BTC or ETH options at a specified expiry date on Base mainnet, paid via x402 at $0.02 USDC per call.

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/ivsmile?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-v1-ivsmile-implied-volatility-smile-lookup-809615f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HnWIa6gDaK4Gj1HeZs6N0

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 beggar-bot-v1-ivsmile-implied-volatility-smile-lookup-809615f8
```

Example prompt: Can you fetch the implied volatility smile for BTC options with an expiry of 27NOV26 on Base mainnet? I need the full IV curve data.

## When to prefer this

Use this endpoint when you need on-demand implied volatility smile data for BTC or ETH options on Base mainnet via a micropayment-gated API. Prefer this over centralized options data providers when operating within a crypto-native, x402-payment-enabled agent workflow. Useful for agents that need real-time IV curve data without a subscription.

## Known failure modes

- Payment failure: insufficient USDC balance on Base mainnet returns 402 Payment Required
- Invalid currency: values other than BTC or ETH rejected
- Invalid expiry format: expiry must follow the e.g. 27NOV26 convention and be more than 6 days out
- Network unavailable: Base mainnet or base-sepolia RPC errors may cause timeouts
- Missing required params: omitting currency or expiry returns a 400 error

## How this service works

Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.

## Output

Returns JSON containing implied volatility smile data for the requested crypto asset and expiry date, including volatility values across the strike price range, enabling options pricing analysis and strategy construction.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "expiry": {
       "type": "string",
       "description": "e.g. 27NOV26 (first >6d)"
      },
      "currency": {
       "type": "string",
       "description": "BTC or ETH"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-v1-ivsmile-implied-volatility-smile-lookup-809615f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beggar-bot-demand.beggarbot.workers.dev](https://www.zero.xyz/host/beggar-bot-demand.beggarbot.workers.dev/llms.txt)