---
title: "Get Option Chain Snapshot"
method: GET
path: "/options/snapshot/chain/{underlyingAsset}"
tags: ["Options - Snapshot"]
---

# Get Option Chain Snapshot

`GET /options/snapshot/chain/{underlyingAsset}`

Retrieves a comprehensive snapshot of all options contracts for a specified underlying asset ticker.
This consolidates key metrics like pricing, greeks, IV, quotes, trades, and open interest.

## Path parameters

- `underlyingAsset` string, required

## Query parameters

- `strike-price` number
- `strike_price.gt` number
- `strike_price.gte` number
- `strike_price.lt` number
- `strike_price.lte` number
- `expiration-date` string, date
- `expiration_date.gt` string, date
- `expiration_date.gte` string, date
- `expiration_date.lt` string, date
- `expiration_date.lte` string, date
- `contract-type` 'call' | 'put'
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` string

## Response `200`

Successful response with the option chain snapshot data. Keys are in kebab-case.

- object
  - `request-id` string — A request id assigned by the server.
  - `status` string — The status of this request's response.
  - `results` object[]
    - `break-even-price` number — The price of the underlying asset for the contract to break even.
    - `day` object — The most recent daily bar for this contract.
    - `details` object — The details for this contract (strike, expiration, type, etc.).
    - `greeks` object — The greeks for this contract (delta, gamma, theta, vega). May not always be present.
    - `implied-volatility` number, nullable — The market's forecast for the volatility of the underlying asset.
    - `last-quote` object — The most recent quote for this contract (bid/ask price and size). Requires quotes plan.
    - `last-trade` object — The most recent trade for this contract (price, size, timestamp). Requires trades plan.
    - `open-interest` number — The quantity of this contract held at the end of the last trading day.
    - `underlying-asset` object — Information on the underlying stock for this options contract.
  - `next-url` string, nullable — URL to fetch the next page of results, if available.

## Other responses

- `400` — Bad Request - Invalid parameters provided.
- `401` — Unauthorized - API Key is missing or invalid. (Mapped to 500 internal error)
- `404` — Not Found - The requested underlying asset symbol does not exist or has no options data.
- `429` — Too Many Requests - Rate limit exceeded.
- `500` — Internal Server Error or Upstream API issue.

---

[API](https://skmtc.net/laksmono---company/apis/finbud-api.md) · [All operations](https://skmtc.net/laksmono---company/apis/finbud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/laksmono---company/finbud-api/revisions/742d2654c09a/schema)