## finance/options

`GET /v1/finance/options`

The nearest expiry's options chain for one instrument: calls and puts with strike, last, bid, ask, volume, open interest and implied volatility, plus the other expiries.

*Options chain*

| Parameter | Required | Description |
| --- | --- | --- |
| `symbol` | yes | Ticker symbol — e.g. `AAPL` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/finance/options?symbol=AAPL" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "calls": [
    {
      "ask": 0,
      "bid": 0,
      "change": 0,
      "change_percent": 0,
      "implied_volatility": 0,
      "in_the_money": false,
      "last": 0,
      "open_interest": 0,
      "strike": 0,
      "symbol": "example",
      "volume": 0
    }
  ],
  "expiries": [
    "example"
  ],
  "expiry": "example",
  "has_mini_options": false,
  "puts": [
    {
      "ask": 0,
      "bid": 0,
      "change": 0,
      "change_percent": 0,
      "implied_volatility": 0,
      "in_the_money": false,
      "last": 0,
      "open_interest": 0,
      "strike": 0,
      "symbol": "example",
      "volume": 0
    }
  ],
  "quote": {
    "as_of": "example",
    "change": 0,
    "change_percent": 0,
    "currency": "example",
    "day_high": 0,
    "day_low": 0,
    "exchange": "example",
    "fifty_two_week_high": 0,
    "fifty_two_week_low": 0,
    "market_cap": 0,
    "market_state": "example",
    "name": "example",
    "open": 0,
    "previous_close": 0,
    "price": 0,
    "shares_outstanding": 0,
    "symbol": "example",
    "type": "example",
    "volume": 0
  },
  "strikes": [
    0
  ],
  "symbol": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/finance/options#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/finance/options.json)