---
title: "GET /options/v3/trades/{ticker}"
method: GET
path: "/options/v3/trades/{ticker}"
tags: ["us_options"]
---

# GET /options/v3/trades/{ticker}

`GET /options/v3/trades/{ticker}`

Contains individual trade transactions for US options contracts, capturing trade execution details including pricing, timing, and exchange information.

## Path parameters

- `ticker` string, required

## Query parameters

- `timestamp` string
- `timestamp.gt` string
- `timestamp.gte` string
- `timestamp.lt` string
- `timestamp.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `conditions` integer[] — A list of condition codes.
    - `exchange` integer, required — The exchange ID.
    - `participant_timestamp` integer — The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the trade was actually generated at the exchange.
    - `price` number, double, required — The price of the trade. This is the actual dollar value per whole contract of this trade.
    - `sequence_number` integer — The sequence number represents the sequence in which trade events happened. These are increasing and unique per ticker symbol, but will not always be sequential. Values reset after each trading session/day.
    - `sip_timestamp` integer — The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this trade from the exchange which produced it.
    - `size` integer, required — The size of a trade (also known as volume).
    - `ticker` string, required — The options ticker symbol (e.g., O:SPY260123C00687000).
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)