Quotes (NBBO)

get
/v2/ticks/stocks/nbbo/{ticker}/{date}

Get NBBO quotes for a given ticker symbol on a specified date.

This API is being deprecated on June 1, 2022View Current Docs
Parameters

The ticker symbol we want quotes for.

The date/day of the quotes to retrieve in the format YYYY-MM-DD.

The timestamp offset, used for pagination. This is the offset at which to start the results. Using the timestamp of the last result as the offset will give you the next page of results.

The maximum timestamp allowed in the results.

  • Reverse the order of the results.

    Limit the size of the response, max 50000 and default 5000.

    https://api.polygon.io/v2/ticks/stocks/nbbo/{ticker}/{date}?apiKey=*
    Response Attributes
    db_latencyinteger

    Latency in milliseconds for the query results from the database.


    results_countinteger

    The total number of results for this request.


    successboolean

    Whether or not this query was executed successfully.


    tickerstring

    The exchange symbol that this item is traded under.


    resultsarray
    T*string

    The exchange symbol that this item is traded under.


    f*integer

    The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.


    q*integer

    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).


    t*integer

    The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.


    y*integer

    The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.


    P*number

    The ask price.


    S*integer

    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.


    X*integer

    Ask Exchange Id


    c*array [integer]

    A list of condition codes.


    i*array [integer]

    The indicators. For more information, see our glossary of Conditions and Indicators.


    p*number

    The bid price.


    s*integer

    The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.


    x*integer

    Bid Exchange Id


    z*integer

    There are 3 tapes which define which exchange the ticker is listed on. These are integers in our objects which represent the letter of the alphabet. Eg: 1 = A, 2 = B, 3 = C.

    • Tape A is NYSE listed securities
    • Tape B is NYSE ARCA / NYSE American
    • Tape C is NASDAQ

    Was this helpful?
    Help us improve
    Response Object
    {
      "db_latency": 43,
      "map": {
        "P": {
          "name": "ask_price",
          "type": "float64"
        },
        "S": {
          "name": "ask_size",
          "type": "int"
        },
        "X": {
          "name": "ask_exchange",
          "type": "int"
        },
        "c": {
          "name": "conditions",
          "type": "int"
        },
        "f": {
          "name": "trf_timestamp",
          "type": "int64"
        },
        "i": {
          "name": "indicators",
          "type": "int"
        },
        "p": {
          "name": "bid_price",
          "type": "float64"
        },
        "q": {
          "name": "sequence_number",
          "type": "int"
        },
        "s": {
          "name": "bid_size",
          "type": "int"
        },
        "t": {
          "name": "sip_timestamp",
          "type": "int64"
        },
        "x": {
          "name": "bid_exchange",
          "type": "int"
        },
        "y": {
          "name": "participant_timestamp",
          "type": "int64"
        },
        "z": {
          "name": "tape",
          "type": "int"
        }
      },
      "results": [
        {
          "P": 0,
          "S": 0,
          "X": 0,
          "c": [
            1
          ],
          "p": 102.7,
          "q": 2060,
          "s": 60,
          "t": 1517562000065700400,
          "x": 11,
          "y": 1517562000065321200,
          "z": 3
        },
        {
          "P": 0,
          "S": 0,
          "X": 0,
          "c": [
            1
          ],
          "p": 170,
          "q": 2061,
          "s": 2,
          "t": 1517562000065791500,
          "x": 11,
          "y": 1517562000065408300,
          "z": 3
        }
      ],
      "results_count": 2,
      "success": true,
      "ticker": "AAPL"
    }
    All data provided on Polygon is provided for informational purposes only, and is not intended for trading or investing purposes. Polygon provides all information as is. You must not redistribute information displayed on or provided by Polygon. Stock prices displayed in the ticker are from a subset of exchanges, this price does not represent the real-time price from the SIP.

    © Polygon.io, Inc