---
title: "Get Vol Grids"
method: GET
path: "/v1/vol-grids"
tags: ["asset-data"]
---

# Get Vol Grids

`GET /v1/vol-grids`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/vol-grids`
- Auth: none required
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/vol-grids/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns grids for **all** options-enabled underlyings.

## Response `200`

OK

- VolGridConfiguration[]
  - `assetId` string: underlying asset ID
  - `assetSymbol` string: underlying asset symbol
  - `effectiveFromDatetime` string, date-time: ISO 8601 datetime of when this vol grid configuration became effective
  - `volGrid` VolGridData[]: list of vol grid rows, one per days-to-expiry bucket
    - `timeToExpiryDays` integer: days-to-expiry bucket this row applies to. supported buckets — [0, 1, 7, 14, 30, 60, 90, 180]
    - `atmMax` string: max upward ATM IV shift applied in BPM stress. supported range — [0, 1]
    - `atmMin` string: max downward ATM IV shift. supported range — [-1, 0]
    - `skewMax` string: max upward skew shift. supported range — [0, 1]
    - `skewMin` string: max downward skew shift. supported range [-1, 0]

## Other responses

- `500`: Internal Server Error

---

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