---
title: "Historical NBBO"
method: GET
path: "/stock/bbo"
tags: ["Default"]
---

# Historical NBBO

`GET /stock/bbo`

Get historical best bid and offer for US stocks, LSE, TSX, Euronext and Deutsche Borse.

For US market, this endpoint only serves historical NBBO from the beginning of 2023. To download more historical data, please visit our bulk download page in the Dashboard [here](/dashboard/download).

## Query parameters

- `symbol` string, required
- `date` string, date, required
- `limit` integer, required
- `skip` integer, required

## Response `200`

successful operation

- HistoricalNBBO
  - `s` string — Symbol.
  - `skip` integer — Number of ticks skipped.
  - `count` integer — Number of ticks returned. If <code>count</code> < <code>limit</code>, all data for that date has been returned.
  - `total` integer — Total number of ticks for that date.
  - `av` number[] — List of Ask volume data.
  - `a` number[] — List of Ask price data.
  - `ax` string[] — List of venues/exchanges - Ask price. A list of exchange codes can be found <a target="_blank" href="https://docs.google.com/spreadsheets/d/1Tj53M1svmr-hfEtbk6_NpVR1yAyGLMaH6ByYU6CG0ZY/edit?usp=sharing",>here</a>
  - `bv` number[] — List of Bid volume data.
  - `b` number[] — List of Bid price data.
  - `bx` string[] — List of venues/exchanges - Bid price. A list of exchange codes can be found <a target="_blank" href="https://docs.google.com/spreadsheets/d/1Tj53M1svmr-hfEtbk6_NpVR1yAyGLMaH6ByYU6CG0ZY/edit?usp=sharing",>here</a>
  - `t` integer[] — List of timestamp in UNIX ms.
  - `c` array[] — List of quote conditions. A comprehensive list of quote conditions code can be found <a target="_blank" href="https://docs.google.com/spreadsheets/d/1iiA6e7Osdtai0oPMOUzgAIKXCsay89dFDmsegz6OpEg/edit?usp=sharing">here</a>
    - string[]

---

[API](https://skmtc.net/finnhub-stock-api/apis/finnhub-api.md) · [All operations](https://skmtc.net/finnhub-stock-api/apis/finnhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finnhub-stock-api/finnhub-api/revisions/415b27331384/schema)