---
title: "Get Option Ladder by Symbol"
method: GET
path: "/v1/option-ladder/{symbol}"
tags: ["derivatives-public"]
---

# Get Option Ladder by Symbol

`GET /v1/option-ladder/{symbol}`

## Request

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

Returns the for a given `baseSymbol`, organized by strike prices and expiration dates. This data helps traders quickly assess the available options and their respective prices, implied volatilities, and Greeks (such as delta, gamma, theta, and vega).

## Path parameters

- `symbol` string, required: market symbol. E.g. `BTC-USDC-20241004-70000-C` for OPTION markets.

## Response `200`

OK

- OptionLadderResponse: Option Ladder Response
  - `symbol` string: market symbol. E.g. `BTC-USDC-20241004-70000-C` for OPTION markets.
  - `baseSymbol` string: asset symbol as denoted in the world
  - `settlementAssetSymbol` string: asset symbol as denoted in the world
  - `bidQuantity` string: Quantity of `bid`
  - `askQuantity` string: Quantity of `ask`
  - `bidIVPercentage` string: Implied volatility of the best bid price
  - `askIVPercentage` string: Implied volatility of the best ask price
  - `bid` string: Bid price in the order book
  - `ask` string: Ask price in the order book
  - `underlyingPrice` string: Index price of the base asset
  - `optionStrikePrice` string: Strike price of the option market
  - `markPrice` string: Mark Price of the option market
  - `quantity` string: Number of contracts outstanding
  - `openInterest` string: Amount of outstanding contracts in the exchange
  - `openInterestUSD` string: USD value of outstanding contracts in the exchange
  - `optionType` 'CALL' | 'PUT': Type of Option market
  - `expiryDatetime` string, date-time: ISO 8601 with millisecond as string
  - `greeks` OptionGreeks: Pricing parameters for option instruments. Only returned for option markets and omitted for spot and perpetual markets.
    - `delta` string: Sensitivity of an option's price to a $1 change in the price of the underlying asset. Only present for option markets.
    - `gamma` string: Rate of change of Delta with respect to a $1 change in the underlying asset's price. Only present for option markets.
    - `theta` string: The rate at which an option's price decreases as it approaches its expiration date. Only present for option markets.
    - `vega` string: Sensitivity of an option's price to a 1% change in the implied volatility of the underlying asset. Only present for option markets.

## Other responses

- `400`: Bad Request
- `404`: Option Market Not Found
- `429`: Too Many Requests
- `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)