---
title: "Stock options volatility (Pro)"
method: GET
path: "/api/v1/stocks/{ticker}/options"
tags: ["Stocks"]
---

# Stock options volatility (Pro)

`GET /api/v1/stocks/{ticker}/options`

## Request

- Base URL: `https://foliofact.com`
- URL: `https://foliofact.com/api/v1/stocks/{ticker}/options`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Daily 30-day implied volatility history with staleness metadata.

## Path parameters

- `ticker` string, required

## Response `200`

IV readings

- StockOptions
  - `ticker` string, required
  - `name` string, nullable, required
  - `expected_reading_date` string, date, required
  - `stale` boolean, required
  - `latest` IVReading, required
    - `date` string, date, required
    - `iv30` number, required: Annualized 30-day implied volatility as a fraction; 0.27 means 27%.
    - `hv30` number, nullable, required: Annualized 30-day historical volatility as a fraction; 0.21 means 21%.
    - `fetched_at` string, date-time, required: Timestamp when FolioFact retrieved the provider observation, distinct from the observation date.
    - `source` string, required
    - `source_label` string, required
    - `unit` 'annualized_fraction', required
  - `history` IVReading[], required
    - `date` string, date, required
    - `iv30` number, required: Annualized 30-day implied volatility as a fraction; 0.27 means 27%.
    - `hv30` number, nullable, required: Annualized 30-day historical volatility as a fraction; 0.21 means 21%.
    - `fetched_at` string, date-time, required: Timestamp when FolioFact retrieved the provider observation, distinct from the observation date.
    - `source` string, required
    - `source_label` string, required
    - `unit` 'annualized_fraction', required

## Other responses

- `403`: Structured error
- `404`: Structured error
- `429`: Rate limit exceeded
- `default`: Structured error

---

[API](https://skmtc.dev/foliofact/apis/foliofact-api.md) · [All operations](https://skmtc.dev/foliofact/apis/foliofact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foliofact/apis/foliofact-api/revisions/a92e927f23f4?raw)