Options Trades

Get tick-level trade data for options contracts with precise timestamps. Includes trade conditions, exchange information, and participant timestamps.

Use Case: Analyze options order flow, build time and sales for options, and track unusual options activity.

GET /v1/options/trades

Get Options Trades

cURL

curl --request GET \
  --url https://api.aries.com/v1/options/trades \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "nextUrl": "https://api.aries.com/v1/options/trades?next=YXA9MTAwMCZhcz1vcHRpb25zLXRyYWRlcyZsaW1pdD0xMDAwJm9yZGVyPWRlc2Mmc29ydD10aW1lc3RhbXAmdGltZXN0YW1wLmx0ZT0yMDIzLTAxLTExVDE2JTNBMDMlM0E0My4zOTRa&ticker=O%3AAAPL230120C00150000",
  "requestId": "dbfa60aa037390553e639aae76021193",
  "results": [
    {
      "conditions": [
        232
      ],
      "exchange": 308,
      "participantTimestamp": 1674248368870000000,
      "price": 0.01,
      "sipTimestamp": 1674248368870000000,
      "size": 2
    },
    {
      "conditions": [
        209
      ],
      "exchange": 301,
      "participantTimestamp": 1673453023394000000,
      "price": 0.04,
      "sipTimestamp": 1673453023394000000,
      "size": 11
    }
  ],
  "status": "OK"
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

ticker · string · required

Options contract ticker symbol. Enter the exact option symbol returned by option search or chain endpoints.

Example:

"O:AAPL230120C00150000"

timestamp · string

Query by timestamp (YYYY-MM-DD or nanoseconds)

Example:

"2024-01-15"

timestampFrom · string

Timestamp start filter. Returns records at or after this timestamp.

Example:

"2024-01-01"

timestampAfter · string

Timestamp lower-bound filter. Returns records after this timestamp, excluding the timestamp itself.

Example:

"2024-01-01"

timestampTo · string

Timestamp end filter. Returns records at or before this timestamp.

Example:

"2024-01-31"

timestampBefore · string

Timestamp upper-bound filter. Returns records before this timestamp, excluding the timestamp itself.

Example:

"2024-01-31"

order · enum<string> · default: asc

Sort order for returned records. Use asc for oldest first or desc for newest first when supported.

Available options: asc, desc

limit · integer

Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits.

Required range: 1 <= x <= 50000

Example:

1000

sort · string

Sort field used for ordering. Massive documents this separately from order, so enter the provider-supported field name in the text box, for example timestamp.

next · string

Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page.

Response

200

application/json

Successful response

nextUrl · string

URL for next page of results

requestId · string

Unique request ID

results · object[]

Array of options trade objects

Show child attributes

status · string

Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.