EQequibles
Options

The trade tape for one option contract by its OCC symbol, active or expired, newest first: time, price, size, exchange and condition. A cancelled print stays in the tape with `cancelled: true`, so read volume from the bars rather than a sum of prints. Defaults to the last 4 days; `startDate` and `endDate` set another window, and history begins in early 2024. When `truncated` is true, pass the oldest row's `time` as `endTime` to continue. Plus receives trades 15 minutes after they print. The Free plan covers end-of-day data only and receives 403. US listings only.

get/v1/securities/{ticker}/options/contract/trades

Request

Path parameters

tickerstring required

Exact listed underlying (e.g. GOOG, GOOGL, BRK-A, or BRK-B). A listing never falls through to its sibling; dot class-share spelling such as BRK.B is accepted as BRK-B.

Query parameters

symbolstring

OCC option symbol (e.g. O:AAPL270617C00350000).

startDatestring

First date, YYYY-MM-DD (default: 4 days before end).

endDatestring

Last date, YYYY-MM-DD (default: today).

endTimestring

Last time to include, RFC 3339; replaces endDate. To continue a truncated read, pass the oldest row's time, which can come back again.

limitinteger

Maximum trades to return, newest first (default: 250, max: 500).

Response

OK

tickerstring nullable
startDatestring date
endDatestring date
returnedinteger
truncatedboolean

True when older trades exist in the window; pass the oldest row's time as endTime to continue.

delayedboolean

True on Plus, where trades younger than 15 minutes are withheld.

Changes

No recorded changes to this operation across all 1 revision of this API.