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

# Historical auctions (single)

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

## Request

- Base URL: `https://data.giftcity.in.alpaca.markets`
- URL: `https://data.giftcity.in.alpaca.markets/v2/stocks/{symbol}/auctions`
- Auth: one of:
  - API key in header `APCA-API-KEY-ID` and API key in header `APCA-API-SECRET-KEY`
  - HTTP basic

The historical auctions endpoint provides auction prices for the given 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` string
- `currency` string
- `page_token` string
- `sort` 'asc' | 'desc': Sort data in ascending or descending order.

## Response `200`

OK

- StockAuctionsRespSingle
  - `auctions` StockDailyAuctions[], required
    - `c` StockAuction[], required: Closing auctions. Every price / exchange / condition triplet is only shown once, with its earliest timestamp.
      - `c` string, required: The condition flag indicating that this is an auction. See `v2/stocks/meta/conditions/trade` for more details.
      - `p` number, double, required: Auction price.
      - `s` integer: Auction trade size.
      - `t` string, date-time, required: Timestamp in RFC-3339 format with nanosecond precision.
      - `x` string, required: Exchange code. See `v2/stocks/meta/exchanges` for more details.
    - `d` string, date, required: Date in RFC-3339.
    - `o` StockAuction[], required: Opening auctions.
      - `c` string, required: The condition flag indicating that this is an auction. See `v2/stocks/meta/conditions/trade` for more details.
      - `p` number, double, required: Auction price.
      - `s` integer: Auction trade size.
      - `t` string, date-time, required: Timestamp in RFC-3339 format with nanosecond precision.
      - `x` string, required: Exchange code. See `v2/stocks/meta/exchanges` for more details.
  - `currency` string
  - `next_page_token` string, nullable, required: Pagination token for the next page.
  - `symbol` string, 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.dev/alpacahq/apis/market-data-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/market-data-api/revisions/82f96f2d0134?raw)