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

# Trades

`GET /v3/trades/{stockTicker}`

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

## Path parameters

- `stockTicker` 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.
    - `decimal_size` string, required — The size of the trade including the fractional component. This is represented as a decimal string.
    - `exchange` integer, required — The exchange ID. See <a href="https://massive.com/docs/rest/stocks/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
    - `id` string, required — The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.
    - `participant_timestamp` integer, required — 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, required — 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 (e.g., 1, 2, 6, 9, 10, 11). Values reset after each trading session/day.
    - `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).
    - `tape` integer — There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C. * Tape A is NYSE listed securities * Tape B is NYSE ARCA / NYSE American * Tape C is NASDAQ
    - `trf_id` integer — The ID for the Trade Reporting Facility where the trade took place.
    - `trf_timestamp` integer — The nanosecond accuracy TRF (Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this trade.
  - `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)