---
title: "List Spot trades"
method: GET
path: "/v1/spot/trades"
tags: ["Spot market data"]
---

# List Spot trades

`GET /v1/spot/trades`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/spot/trades`
- Auth: none required

Market-wide executions, not your private fills. aggressor_side identifies the taker side.

See the [Spot API guide](/api-reference/spot-api-guide).

## Query parameters

- `market` string, required
- `cursor` string
- `limit` integer

## Response `200`

Success. Inspect item-level outcomes for batch operations.

- object
  - `success` boolean, required
  - `result` SpotTrade[], nullable
    - `market` string, required: Trading market
    - `price` string, required: Trade price
    - `size` string, required: Trade size in base currency
    - `cost` string, required: Trade cost in quote currency
    - `aggressor_side` 'buy' | 'sell', required: Side of the aggressing (taker) order
    - `time` string, date-time, required: Time the trade occurred
    - `id` string, required: Trade/fill ID
  - `pageInfo` object
    - `prevCursor` string
    - `nextCursor` string

## Other responses

- `400`: Validation error; inspect error_code and error.
- `429`: Rate limit exceeded. Slow down request frequency.

## Changes

- **2026-11-03** `1601c3adedda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/changes/v1/spot/trades/get.md)

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)