---
title: "Volatility Surface"
method: GET
path: "/v1/volatility/{ticker}/surface"
tags: ["volatility"]
---

# Volatility Surface

`GET /v1/volatility/{ticker}/surface`

## Request

- Base URL: `https://api.optionwhales.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optionwhales.io/v1/volatility/{ticker}/surface`
- Auth: none declared

Full implied-vol surface — ``iv[][]`` over moneyness × DTE, with the
aligned strike/delta/oi/volume matrices and ATM stats (Pro+).

## Path parameters

- `ticker` string, required

## Query parameters

- `dte_min` integer
- `dte_max` integer
- `mode` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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