---
title: "Historical trades (single symbol)"
method: GET
path: "/v2/stocks/{symbol}/trades"
tags: ["Stock"]
---

# Historical trades (single symbol)

`GET /v2/stocks/{symbol}/trades`

The historical stock trades API provides trade data for a stock symbol between the specified dates.

## Path parameters

- `symbol` string, required

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `limit` integer
- `asof` string
- `feed` 'iex' | 'otc' | 'sip' | 'boats'
- `currency` string
- `page_token` string
- `sort` 'asc' | 'desc' — Sort data in ascending or descending order.

## Response `200`

OK

- StockTradesRespSingle
  - `currency` string
  - `next_page_token` string, nullable, required — Pagination token for the next page.
  - `symbol` string, required
  - `trades` StockTrade[], required
    - `c` string[], required — Condition flags. See `v2/stocks/meta/conditions/trade` for more details.
    - `i` integer, required — Trade ID sent by the exchange.
    - `p` number, double, required — Trade price.
    - `s` integer, required — Trade size.
    - `t` string, date-time, required — Timestamp in RFC-3339 format with nanosecond precision.
    - `u` string — Update to the trade. This field is optional, if it's missing, the trade is valid. Otherwise, it can have these values: - canceled: indicates that the trade has been canceled - incorrect: indicates that the trade has been corrected and the given trade is no longer valid - corrected: indicates that this trade is the correction of a previous (incorrect) trade
    - `x` string, required — Exchange code. See `v2/stocks/meta/exchanges` for more details.
    - `z` 'A' | 'B' | 'C' | 'N' | 'O', required — - A: New York Stock Exchange - B: NYSE Arca, Bats, IEX and other regional exchanges - C: NASDAQ - N: Overnight - O: OTC

## Other responses

- `400` — One of the request parameters is invalid. See the returned message for details.
- `401` — Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.
- `403` — The requested resource is forbidden.
- `429` — Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500` — Internal server error. We recommend retrying these later. If the issue persists, please contact us on [Slack](https://alpaca.markets/slack) or on the [Community Forum](https://forum.alpaca.markets/).

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)