# Implied Volatility Term Structure

`GET` `https://api.unusualwhales.com/api/stock/{ticker}/volatility/term-structure`

The average of the latest volatilities for the at the money call and put contracts for every expiry date.


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | SingleTicker | Yes | A single ticker |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `date` | Optional Market Date | No | A trading date in the format of YYYY-MM-DD.
This is optional and by default the last trading date.
 |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `date` | Market General Trading day | A trading date in ISO format.
 |
| `dte` | DTE | The number of days until the option expires. |
| `expiry` | Stock Expiry | The expiry of an options cycle as an ISO date. |
| `implied_move` | Stock Implied Move | The implied move of the underlying stock by a given date based on the money option contracts. It is calculated by multiplying the sum of the call and put price by 0.85. If no expiry date is included, then the implied move is for the nearest end of the week expiration (the nearest monthly expiration if there are no weekly contracts). |
| `implied_move_perc` | Stock Implied Move Perc | The implied move as a percentage of the underlying stock price. |
| `volatility` | Stock Volatility | The implied volatility average of the at the money put and call option contracts. If no expiry date is included, then the volatility is of the nearest end of the week expiration (the nearest monthly expiration if there are no weekly contracts). |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/stock/{ticker}/volatility/term-structure" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/stock/{ticker}/volatility/term-structure", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "date": "2023-09-08",
      "dte": 0,
      "expiry": "2023-09-08",
      "implied_move": "3.1025",
      "implied_move_perc": "0.01765",
      "volatility": "0.2319"
    },
    {
      "date": "2023-09-08",
      "dte": 7,
      "expiry": "2023-09-15",
      "implied_move": "4.923",
      "implied_move_perc": "0.02747",
      "volatility": "0.2352"
    }
  ]
}
```