---
title: "Get Vol Grid by Symbol"
method: GET
path: "/v1/assets/{symbol}/vol-grid"
tags: ["asset-data"]
---

# Get Vol Grid by Symbol

`GET /v1/assets/{symbol}/vol-grid`

## Request

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

Returns the current active BPM (Bullish Portfolio Margin) vol grid configuration for the specified underlying asset.

## Path parameters

- `symbol` string, required

## 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

- `400`: Invalid asset symbol
- `404`: Vol grid config not found for assetSymbol
- `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)