Stock Trades

Get tick-level trade data for a stock with precise timestamps. Provides granular trade information including exchange, conditions, and participant timestamps.

Use Case: Build time and sales displays, analyze order flow, and create tick-by-tick trading analysis tools.

GET /v1/stocks/trades

Get Stock Trades

cURL

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

200

Example

{
  "nextUrl": "https://api.aries.com/v1/stocks/trades?next=YXA9MTAwMDM3MDkmYXM9YXRsYXMtc3RvY2tzLXRyYWRlcyZsaW1pdD0xMDAwJm9yZGVyPWRlc2Mmc29ydD10aW1lc3RhbXAmdGltZXN0YW1wLmx0ZT0yMDI2LTAxLTAyVDIyJTNBNTAlM0EwNS4xNzU5NTM5NTRa&ticker=AAPL",
  "requestId": "065feb8d4f03d1b18c1f13237a342e3f",
  "results": [
    {
      "conditions": [
        12
      ],
      "exchange": 4,
      "id": "360988",
      "participantTimestamp": 1767401995260648000,
      "price": 270.9607,
      "sequenceNumber": 10029677,
      "sipTimestamp": 1767401995260878300,
      "size": 391,
      "tape": 3,
      "trfId": 202,
      "trfTimestamp": 1767401995260857300
    }
  ],
  "status": "DELAYED"
}

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

Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.

Example:

"AAPL"

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 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.