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

# Get Option Ladder by Base Symbol

`GET /v1/option-ladder`

## Request

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

Returns the available options contracts. This data helps traders quickly assess the available options and their respective prices, implied volatilities, and Greeks (such as delta, gamma, theta, and vega).

## Query parameters

- `baseSymbol` string, required: asset symbol as denoted in the world
- `expiry` string: Expiry date of the option market in YYYYMMDD format (e.g. 20250520)
- `type` 'CALL' | 'PUT': Type of Option market
- `sort` 'optionType' | 'expiryDatetime': Sorting parameter that can have the following string values `"optionType"`, `"expiryDatetime"`

## Response `200`

OK

- OptionLadderResponse[]
  - `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
- `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)