Trades
GET
/v3/trades/{cryptoTicker}
Retrieve comprehensive, tick-level trade data for a specified crypto ticker within a defined time range. Each record includes price, size, exchange, trade conditions, and precise timestamp information. This granular data is foundational for constructing aggregated bars and performing in-depth analyses, as it captures every trade that contributes to calculations of open, high, low, and close (OHLC) values. By leveraging these trades, users can refine their understanding of intraday price movements, test and optimize algorithmic strategies, and ensure compliance by maintaining an auditable record of market activity.
Use Cases: Intraday analysis, algorithmic trading, market microstructure research, data integrity and compliance.
Path Parameters
cryptoTicker
string
required
The ticker symbol to get trades for.
Query Parameters
timestamp
string
Query by trade timestamp. Either a date with the format YYYY-MM-DD or a nanosecond timestamp.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 1000 and max is 50000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
optional
A request id assigned by the server.
results
array (object)
optional
An array of results containing the requested data.
conditions
array (integer)
optional
A list of condition codes.
exchange
integer
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
id
string
optional
The Trade ID which uniquely identifies a trade on the exchange that the trade happened on.
participant_timestamp
integer
optional
The nanosecond Exchange Unix Timestamp. This is the timestamp of when the trade was generated at the exchange.
price
number
The price of the trade in the base currency of the crypto pair.
size
number
The size of a trade (also known as volume).
status
string
The status of this request's response.