Qodex.ai

Historical trades

GET {{baseUrl}}/v1beta1/options/trades?symbols=AAPL241220C00300000,AAPL240315C00225000

The historical option trades API provides trade data for a list of contract symbols between the specified dates up to 7 days ago.

The returned results are sorted by symbol first then by trade timestamp. This means that you are likely to see only one symbol in your first response if there are enough trades for that symbol to hit the limit you requested on that request.

In these situations if you keep requesting again with the next_page_token you will eventually reach the next symbols if any trades were found for them.

Request Params

KeyDatatypeRequiredDescription
symbolsstring(Required) Comma separated list of contract symbols with a limit of 100.
startstringThe inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD.
If missing, the default value is the beginning of the current day.
endstringThe inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD.
If missing, the default value is the current time.
limitnumberThe maximum number of data points to return in the response.
The API may return less, even if there are more available data points in the requested interval.
Always check the next_page_token for more pages.
The limit applies to the total number of data points, not per symbol!
page_tokenstringPagination token to continue from. The value to pass here is returned in specific requests when more data is available than the request limit allows.
sortstringSort data in ascending or descending order.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"trades":{"AAPL240112C00182500":[{"t":"2024-01-18T15:03:44.56339456Z","x":"B","p":0.37,"s":1,"c":"I"},{"t":"2024-01-18T16:02:38.994758144Z","x":"C","p":0.34,"s":1,"c":"g"}]},"next_page_token":"QUFQTHwyMDIyLTAxLTAzVDA5OjAwOjAwLjI0NDgzOTY4MFp8UHwwOTIyMzM3MjAzNjg1NDc3NTgxMA=="}