---
title: "OHLCV price bars for a symbol and resolution"
method: GET
path: "/v1/history"
tags: ["History"]
---

# OHLCV price bars for a symbol and resolution

`GET /v1/history`

## Request

- Base URL: `https://flow-api.skylit.ai`
- URL: `https://flow-api.skylit.ai/v1/history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/skylit/apis/flowseeker-skylit-public-api/docs/v1/history/get.ts> (a function with typed inputs; its response is checked against the schema)

TradingView UDF history bars for one `symbol` at one `resolution`,
covering `[from, to)` (Unix seconds; `to` is exclusive). Returns column arrays (`t`, `o`,
`h`, `l`, `c`, `v`) of equal length, oldest-first. When the window
holds no bars the response is a `200` with `{ "s": "no_data" }` (plus
`nextTime` pointing at the nearest earlier bar when one exists), per the
UDF contract. Equity bars also carry sided-volume columns (`bv`/`sv`/`uv`
= buy / sell / unclassified) where available.

Cache-Control tracks data freshness: today `max-age=2`, the prior
session `max-age=60`, older complete days `immutable`.

## Query parameters

- `symbol` string, required
- `resolution` '1' | '2' | '3' | '5' | '15' | '30' | '60' | '240' | '480' | 'D' | 'W', required
- `from` integer, required
- `to` integer, required
- `countback` integer
- `extended` boolean

## Response `200`

Bars, or a `no_data` marker — both `200` per UDF.

- union
  - HistoryOk
    - `s` 'ok', required: Status flag.
    - `t` integer[], required: Bar open times, Unix seconds (UTC), oldest-first.
    - `o` number[], required: Opens.
    - `h` number[], required: Highs.
    - `l` number[], required: Lows.
    - `c` number[], required: Closes.
    - `v` number[], required: Volumes.
    - `bv` number[]: Buy (aggressor) volume per bar, equities where available.
    - `sv` number[]: Sell (aggressor) volume per bar.
    - `uv` number[]: Unclassified volume per bar.
  - HistoryNoData
    - `s` 'no_data', required
    - `nextTime` integer: Unix seconds of the nearest earlier bar, when one exists.

## Other responses

- `401`: Missing or invalid API key.
- `402`: The account's shared Skylit credit balance is lower than this route's cost. Top up to continue. Carries `X-Credits-Remaining: 0`.
- `403`: Account is not API-eligible (suspended).
- `429`: Per-minute rate limit exceeded.
- `503`: Underlying data source temporarily unavailable, or the credit balance could not be verified (`credit_check_failed`). Safe to retry.

---

[API](https://skmtc.dev/skylit/apis/flowseeker-skylit-public-api.md) - [All operations](https://skmtc.dev/skylit/apis/flowseeker-skylit-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/skylit/apis/flowseeker-skylit-public-api/revisions/3280190b1b24?raw)