nbbo
Get the National Best Bid and Offer for a given stock.
Examples
from openbb import obb
obb.equity.price.nbbo(symbol='AAPL', provider='polygon')
Parameters
- standard
- polygon
Name | Type | Description | Default | Optional |
---|---|---|---|---|
symbol | str | Symbol to get data for. | False |
Name | Type | Description | Default | Optional |
---|---|---|---|---|
symbol | str | Symbol to get data for. | False | |
limit | int | The number of data entries to return. Up to ten million records will be returned. Pagination occurs in groups of 50,000. Remaining limit values will always return 50,000 more records unless it is the last page. High volume tickers will require multiple max requests for a single day's NBBO records. Expect stocks, like SPY, to approach 1GB in size, per day, as a raw CSV. Splitting large requests into chunks is recommended for full-day requests of high-volume symbols. | 50000 | True |
date | Union[date, str] | A specific date to get data for. Use bracketed the timestamp parameters to specify exact time ranges. | None | True |
timestamp_lt | Union[datetime, str] | Query by datetime, less than. Either a date with the format 'YYYY-MM-DD' or a TZ-aware timestamp string, 'YYYY-MM-DDTH:M:S.000000000-04:00'. Include all nanoseconds and the 'T' between the day and hour. | None | True |
timestamp_gt | Union[datetime, str] | Query by datetime, greater than. Either a date with the format 'YYYY-MM-DD' or a TZ-aware timestamp string, 'YYYY-MM-DDTH:M:S.000000000-04:00'. Include all nanoseconds and the 'T' between the day and hour. | None | True |
timestamp_lte | Union[datetime, str] | Query by datetime, less than or equal to. Either a date with the format 'YYYY-MM-DD' or a TZ-aware timestamp string, 'YYYY-MM-DDTH:M:S.000000000-04:00'. Include all nanoseconds and the 'T' between the day and hour. | None | True |
timestamp_gte | Union[datetime, str] | Query by datetime, greater than or equal to. Either a date with the format 'YYYY-MM-DD' or a TZ-aware timestamp string, 'YYYY-MM-DDTH:M:S.000000000-04:00'. Include all nanoseconds and the 'T' between the day and hour. | None | True |
Returns
OBBject
results : List[EquityNBBO]
Serializable results.
provider : Optional[Literal['polygon']]
Provider name.
warnings : Optional[List[Warning_]]
List of warnings.
chart : Optional[Chart]
Chart object.
extra : Dict[str, Any]
Extra info.
Data
- standard
- polygon
Name | Type | Description |
---|---|---|
ask_exchange | str | The exchange ID for the ask. |
ask | float | The last ask price. |
ask_size | int | The ask size. This represents the number of round lot orders at the given ask price. |
The normal round lot size is 100 shares. | ||
An ask size of 2 means there are 200 shares available to purchase at the given ask price. | None | |
bid_size | int | The bid size in round lots. |
bid | float | The last bid price. |
bid_exchange | str | The exchange ID for the bid. |
Name | Type | Description |
---|---|---|
ask_exchange | str | The exchange ID for the ask. |
ask | float | The last ask price. |
ask_size | int | The ask size. This represents the number of round lot orders at the given ask price. |
The normal round lot size is 100 shares. | ||
An ask size of 2 means there are 200 shares available to purchase at the given ask price. | None | |
bid_size | int | The bid size in round lots. |
bid | float | The last bid price. |
bid_exchange | str | The exchange ID for the bid. |
tape | str | The exchange tape. |
conditions | Union[str, List[int], List[str]] | A list of condition codes. |
indicators | List[int] | A list of indicator codes. |
sequence_num | int | The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11) |
participant_timestamp | datetime | The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange. |
sip_timestamp | datetime | The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this quote from the exchange which produced it. |
trf_timestamp | datetime | The nanosecond accuracy TRF (Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this quote. |