option_history_trade
Fetch up to one month of tick-level option trade history. Requires an expiration date; optional filters for date, strike, and right.
Instructions
[STANDARD] Tick-level trade history for options. Max 1 month, requires expiration.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | The date to fetch data for. If present, this overrides start_date and end_date. | |
| right | No | The right (call or put) of the contract. | both |
| strike | No | The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes. | * |
| symbol | Yes | The stock or index symbol, or underlying symbol for options. | |
| max_dte | No | If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned. | |
| end_date | No | The end date (inclusive). | |
| end_time | No | The end time (inclusive) in the specified day. | 16:00:00 |
| expiration | Yes | The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations. | |
| start_date | No | The start date (inclusive). | |
| start_time | No | The start time (inclusive) in the specified day. | 09:30:00 |
| strike_range | No | Used to specify a filter to limit the number of contracts returned relative to the underlying's spot price. Will return the specified number of strikes above and below the spot price, as well as the at-the-money strike. |