Get trades for a given ticker symbol on a specified date.
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.
Latency in milliseconds for the query results from the database.
The total number of results for this request.
Whether or not this query was executed successfully.
The exchange symbol that this item is traded under.
The exchange symbol that this item is traded under.
The nanosecond accuracy TRF(Trade Reporting Facility) Unix Timestamp. This is the timestamp of when the trade reporting facility received this message.
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).
The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it.
The nanosecond accuracy Participant/Exchange Unix Timestamp. This is the timestamp of when the quote was actually generated at the exchange.
A list of condition codes.
The trade correction indicator.
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.
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.
The ID for the Trade Reporting Facility where the trade took place.
The size of a trade (also known as volume).
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
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.
{
"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"
}