Trades

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

Get trades for a given ticker symbol on a specified date.

This API was deprecated on June 1, 2022 and is no longer supported.View Current Docs
Parameters

The ticker symbol we want trades for.

The date/day of the trades 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/trades/{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.


    c*array [integer]

    A list of condition codes.


    e*integer

    The trade correction indicator.


    i*string

    The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.


    p*number

    The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.


    r*integer

    The ID for the Trade Reporting Facility where the trade took place.


    s*number

    The size of a trade (also known as volume).


    x*integer

    The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.


    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": 11,
      "map": {
        "I": {
          "name": "orig_id",
          "type": "string"
        },
        "c": {
          "name": "conditions",
          "type": "int"
        },
        "e": {
          "name": "correction",
          "type": "int"
        },
        "f": {
          "name": "trf_timestamp",
          "type": "int64"
        },
        "i": {
          "name": "id",
          "type": "string"
        },
        "p": {
          "name": "price",
          "type": "float64"
        },
        "q": {
          "name": "sequence_number",
          "type": "int64"
        },
        "r": {
          "name": "trf_id",
          "type": "int"
        },
        "s": {
          "name": "size",
          "type": "int"
        },
        "t": {
          "name": "sip_timestamp",
          "type": "int64"
        },
        "x": {
          "name": "exchange",
          "type": "int"
        },
        "y": {
          "name": "participant_timestamp",
          "type": "int64"
        },
        "z": {
          "name": "tape",
          "type": "int"
        }
      },
      "results": [
        {
          "c": [
            12,
            41
          ],
          "i": "1",
          "p": 171.55,
          "q": 1063,
          "s": 100,
          "t": 1517562000016036600,
          "x": 11,
          "y": 1517562000015577000,
          "z": 3
        },
        {
          "c": [
            12,
            41
          ],
          "i": "2",
          "p": 171.55,
          "q": 1064,
          "s": 100,
          "t": 1517562000016038100,
          "x": 11,
          "y": 1517562000015577600,
          "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