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

# Historical bars (single symbol)

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

## Request

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

The historical stock bars API provides aggregates for the stock symbol between the specified dates.

## Path parameters

- `symbol` string, required

## Query parameters

- `timeframe` string, required
- `start` string, date-time
- `end` string, date-time
- `limit` integer
- `adjustment` StockAdjustment[]
- `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

- StockBarsRespSingle
  - `bars` StockBar[], required
    - `c` number, double, required: Closing price.
    - `h` number, double, required: High price.
    - `l` number, double, required: Low price.
    - `n` integer, required: Trade count in the bar.
    - `o` number, double, required: Opening price.
    - `t` string, date-time, required: Timestamp in RFC-3339 format with nanosecond precision.
    - `v` integer, required: Bar volume.
    - `vw` number, double, required: Volume weighted average price.
  - `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)