Returns all trades for a contract between start time and end time, up to seven days ago for the specified source.
| Name | Description | Example |
|---|---|---|
|
identifier
* required
|
The option contract for which trades are being requested. | AAPL__261218C00230000 |
|
source
|
The specific source of the data being requested.
Options:
realtime
delayed
show more
show less
|
realtime |
|
start_date
|
The start date for the data being requested. | 2024-07-05 |
|
start_time
|
The start time for the data being requested. | 39600.0 |
|
end_date
|
The end date for the data being requested. | 2025-07-05 |
|
end_time
|
The end time for the data being requested. | 39600.0 |
|
timezone
|
The timezone the start and end date/times use.
Options:
Africa/Algiers
Africa/Cairo
Africa/Casablanca
Africa/Harare
Africa/Johannesburg
Africa/Monrovia
Africa/Nairobi
America/Argentina/Buenos_Aires
America/Bogota
America/Caracas
America/Chicago
America/Chihuahua
America/Denver
America/Godthab
America/Guatemala
America/Guyana
America/Halifax
America/Indiana/Indianapolis
America/Juneau
America/La_Paz
America/Lima
America/Lima
America/Los_Angeles
America/Mazatlan
America/Mexico_City
America/Mexico_City
America/Monterrey
America/Montevideo
America/New_York
America/Phoenix
America/Regina
America/Santiago
America/Sao_Paulo
America/St_Johns
America/Tijuana
Asia/Almaty
Asia/Baghdad
Asia/Baku
Asia/Bangkok
Asia/Bangkok
Asia/Chongqing
Asia/Colombo
Asia/Dhaka
Asia/Dhaka
Asia/Hong_Kong
Asia/Irkutsk
Asia/Jakarta
Asia/Jerusalem
Asia/Kabul
Asia/Kamchatka
Asia/Karachi
Asia/Karachi
Asia/Kathmandu
Asia/Kolkata
Asia/Kolkata
Asia/Kolkata
Asia/Kolkata
Asia/Krasnoyarsk
Asia/Kuala_Lumpur
Asia/Kuwait
Asia/Magadan
Asia/Muscat
Asia/Muscat
Asia/Novosibirsk
Asia/Rangoon
Asia/Riyadh
Asia/Seoul
Asia/Shanghai
Asia/Singapore
Asia/Srednekolymsk
Asia/Taipei
Asia/Tashkent
Asia/Tbilisi
Asia/Tehran
Asia/Tokyo
Asia/Tokyo
Asia/Tokyo
Asia/Ulaanbaatar
Asia/Urumqi
Asia/Vladivostok
Asia/Yakutsk
Asia/Yekaterinburg
Asia/Yerevan
Atlantic/Azores
Atlantic/Cape_Verde
Atlantic/South_Georgia
Australia/Adelaide
Australia/Brisbane
Australia/Darwin
Australia/Hobart
Australia/Melbourne
Australia/Melbourne
Australia/Perth
Australia/Sydney
Etc/UTC
UTC
Europe/Amsterdam
Europe/Athens
Europe/Belgrade
Europe/Berlin
Europe/Berlin
Europe/Bratislava
Europe/Brussels
Europe/Bucharest
Europe/Budapest
Europe/Copenhagen
Europe/Dublin
Europe/Helsinki
Europe/Istanbul
Europe/Kaliningrad
Europe/Kiev
Europe/Lisbon
Europe/Ljubljana
Europe/London
Europe/London
Europe/Madrid
Europe/Minsk
Europe/Moscow
Europe/Moscow
Europe/Paris
Europe/Prague
Europe/Riga
Europe/Rome
Europe/Samara
Europe/Sarajevo
Europe/Skopje
Europe/Sofia
Europe/Stockholm
Europe/Tallinn
Europe/Vienna
Europe/Vilnius
Europe/Volgograd
Europe/Warsaw
Europe/Zagreb
Pacific/Apia
Pacific/Auckland
Pacific/Auckland
Pacific/Chatham
Pacific/Fakaofo
Pacific/Fiji
Pacific/Guadalcanal
Pacific/Guam
Pacific/Honolulu
Pacific/Majuro
Pacific/Midway
Pacific/Midway
Pacific/Noumea
Pacific/Pago_Pago
Pacific/Port_Moresby
Pacific/Tongatapu
show more
show less
|
UTC |
|
page_size
|
The maximum number of results to return per page. | - |
|
min_size
|
Trades must be larger or equal to this size. | - |
|
next_page
|
Gets the next page of data from a previous API call | - |
|
identifier
* required
The option contract for which trades are being requested.
|
||
|
source
* required
The specific source of the data being requested.
|
||
|
start_date
* required
The start date for the data being requested.
|
||
|
start_time
* required
The start time for the data being requested.
|
||
|
end_date
* required
The end date for the data being requested.
|
||
|
end_time
* required
The end time for the data being requested.
|
||
|
timezone
* required
The timezone the start and end date/times use.
|
||
|
page_size
* required
The maximum number of results to return per page.
|
||
|
min_size
* required
Trades must be larger or equal to this size.
|
||
|
next_page
* required
Gets the next page of data from a previous API call
|
| Name | Description | Type |
|---|---|---|
| next_page | The token required to request the next page of the data. If null, no further results are available. | string |
| source | The source of the trades. | select |
| trades | Array of all the trades in this page of the result. | array |
|
contract
|
The option contract | string |
|
underlying_symbol
|
The ticker symbol | string |
|
timestamp
|
The UTC timestamp at the time of the trade. | string |
|
price
|
The price of the trade. | number |
|
size
|
The size of the trade. | number |
|
total_volume
|
The total volume of the symbol for the day up to the timestamp point in time. | number |
|
ask_price_at_execution
|
The price of ask quote at the time of the trade. | number |
|
bid_price_at_execution
|
The price of bid quote at the time of the trade. | number |
|
exchange
|
The exchange for the trade. | string |
|
conditions
|
The condition of the trade. | string |
|
sequence_id
|
The sequential ID for the trade, ordered as temporally received from the exchange. | number |
|
next_page
The token required to request the next page of the data. If null, no further results are available.
|
||
|
source
The source of the trades.
|
||
|
trades
Array of all the trades in this page of the result.
|
Back to Product Docs