---
title: "Get Options Trades"
method: GET
path: "/options/trades/{optionsTicker}"
tags: ["Options - Trades"]
---

# Get Options Trades

`GET /options/trades/{optionsTicker}`

Retrieves comprehensive, tick-level trade data for a specified options ticker within a defined time range.
Includes price, size, exchange, conditions, and precise timestamps. Max 50,000 results per request.

## Path parameters

- `optionsTicker` string, required

## Query parameters

- `timestamp` string
- `timestamp.gt` string
- `timestamp.gte` string
- `timestamp.lt` string
- `timestamp.lte` string
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` string

## Response `200`

Successful response with options trade data. Keys are in kebab-case.

- object
  - `request-id` string
  - `status` string
  - `results` object[]
    - `conditions` integer[] — List of condition codes.
    - `correction` integer — Trade correction indicator.
    - `exchange` integer — Exchange ID.
    - `participant-timestamp` integer — Participant/Exchange Unix Timestamp (nanoseconds).
    - `price` number — Trade price.
    - `sip-timestamp` integer — SIP Unix Timestamp (nanoseconds).
    - `size` number — Trade size (volume).
  - `next-url` string, nullable — URL for the next page of results.

## Other responses

- `400` — Bad Request - Invalid parameters.
- `401` — Unauthorized - API Key issue. (Mapped to 500)
- `404` — Not Found - Ticker not found.
- `429` — Too Many Requests.
- `500` — Internal Server Error.

---

[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/versions/742d2654c09a/schema)