---
title: "Historical trades"
method: GET
path: "/v2/stocks/trades"
tags: ["Stock"]
---

# Historical trades

`GET /v2/stocks/trades`

The historical stock trades API provides trade data for a list of stock symbols between the specified dates.

The returned results are sorted by symbol first then by trade timestamp. This means that you are likely to see only one symbol in your first response if there are enough trades for that symbol to hit the limit you requested.

In these situations, if you keep requesting again with the `next_page_token` from the previous response, you will eventually reach the other symbols if any trades were found for them.

## Query parameters

- `symbols` string, required
- `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

- StockTradesResp
  - `currency` string
  - `next_page_token` string, nullable, required — Pagination token for the next page.
  - `trades` object, required

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