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

# Trades

`GET /v3/trades/{optionsTicker}`

Get trades for an options ticker symbol in a given time range.

## Path parameters

- `optionsTicker` string, required

## Query parameters

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

## Response `200`

A list of trades.

- object
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string — A request id assigned by the server.
  - `results` object[] — An array of results containing the requested data.
    - `conditions` integer[] — A list of condition codes.
    - `correction` integer — The trade correction indicator.
    - `exchange` integer, required — The exchange ID. See <a href="https://massive.com/docs/rest/options/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
    - `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 share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.
    - `sequence_number` integer — The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be consecutive (e.g. 1, 2, 6, 9, 10, 11).
    - `sip_timestamp` integer, required — The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this trade from the exchange which produced it.
    - `size` number, double, required — The size of a trade (also known as volume).
  - `status` string, required — The status of this request's response.

---

[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)