US Options Trade Only
GET/api/v1/data/us-equity-opt/opt-trades/:trade_date/:ticker
The U.S. Options Trade-Only dataset provides tick-level executed options trades derived from the consolidated Options Price Reporting Authority (OPRA) feed, with trade-anchored market context captured at the time of each execution. Each record includes the executed trade price, size, timestamp, originating exchange, and trade condition codes, along with the prevailing National Best Bid and Offer (NBBO), including bid/ask price, size, and condition, as observed at the moment of the trade. This enables accurate analysis of execution quality, trade aggressiveness, and market state at execution time, without the overhead of a full quote stream. To support option-to-underlying relationship analysis, the dataset also includes underlying asset reference data (bid, ask, and last trade price, size, and timestamp) aligned to the option trade event. Coverage spans all U.S. equity options exchanges reporting via OPRA.
For more details, please refer to the dataset documentation: US Options Trade Only Guide.
Advanced Filtering
You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, StartDate.gt=2023-01-01&StartDate.lt=2023-12-31, Ticker=AAPL.
Please refer to the Advanced Filtering Guide for the extensive reference.
Request
Responses
- 200
- 403
- 422
- 429
JSON, CSV file, or gzip-compressed CSV file, depending on the value of response_format query parameter
Forbidden
Validation Error
Request rejected because the identity or team exceeded a configured monthly or per-minute usage quota. When available, the response includes rate-limit headers describing the current quota.
Response Headers
Configured quota limit for the resource that was exceeded.
Remaining quota before the limit is reached. This is 0 when the request is rejected.
Number of seconds left in the current quota period before usage resets.