---
title: "Trade tape"
method: GET
path: "/trades"
tags: ["Trades"]
---

# Trade tape

`GET /trades`

Returns a paginated list of trades that have occurred on the exchange.
Default page size is 100, maximum is 1000.

The `side` field in the response indicates the taker side of the trade.

### Example

```http
GET /trades?market=BTC-USD-PERP&page_size=100
```

This endpoint supports cursor-based pagination for efficiently traversing large
result sets.

## Query parameters

- `baseAsset` string
- `cursor` string
- `end_at` integer
- `market` string
- `page_size` integer
- `start_at` integer

## Response `200`

OK

- object
  - `next` string — The pointer to fetch next set of records (null if there are no records left)
  - `prev` string — The pointer to fetch previous set of records (null if there are no records left)
  - `results` object[] — Array of paginated results
    - `created_at` integer — Unix Millisecond timestamp at which trade was done
    - `id` string — Unique Trade ID per TradeType
    - `market` string — Market for which trade was done
    - `price` string — Trade price
    - `side` 'BUY' | 'SELL'
    - `size` string — Trade size
    - `trade_type` 'LIQUIDATION' | 'UNWIND_TRANSFER' | 'FILL' | 'SETTLE_MARKET' | 'RPI' | 'BLOCK_TRADE'

## Other responses

- `400` — Bad Request

## Changes

- **2026-07-22** `48fe202ea888` — 1 warning, 1 info
  - added the new `UNWIND_TRANSFER` enum value to the `allOf[subschema #2]/results/items/trade_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
  - removed the `TRANSFER` enum value from the `allOf[subschema #2]/results/items/trade_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
- **2026-07-17** `f1370c46e9e8` — 3 warning
  - added the new `BLOCK_TRADE_REPLAYED_SIGNATURE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `EVM_VAULT_OPERATORS_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `VAULT_DATA_PRIVATE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/trades/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/revisions/a73698fdee53/schema)
