---
title: "List block trades"
method: GET
path: "/block-trades"
tags: ["BlockTrades"]
---

# List block trades

`GET /block-trades`

Get a paginated list of block trades with filtering.

Returns block trades where user is initiator, required signer,
or has submitted an offer.

**Filters:**
- Status: CREATED, OFFER_COLLECTION, READY_TO_EXECUTE, EXECUTING, COMPLETED, CANCELLED
- Market: Specific market symbol (e.g., BTC-USD-PERP)

**Returns:** Paginated list with block trade details and navigation metadata.

## Query parameters

- `status` 'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'COMPLETED' | 'CANCELLED'
- `market` string

## 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
    - `block_expiration` integer — Unix timestamp in milliseconds when block expires
    - `block_id` string — Backend-generated unique identifier
    - `block_type` 'DIRECT' | 'OFFER_BASED'
    - `created_at` integer — When block was created
    - `failure_reason` string — Reason for failure (if status is FAILED). Names a participant by role, never by address: <maker>, <taker>, <initiator>, <participant> (a party whose side is ambiguous), or <redacted> (an identifier belonging to no participant)
    - `initiator` string — Account that initiated this block trade
    - `last_updated_at` integer — When block was last updated
    - `nonce` string — Original block nonce
    - `parent_block_id` string — Parent block ID (if offer-based)
    - `required_signers` string[] — List of accounts that can participate in the block trade
    - `signatures` object — Current signatures on this block (for signature verification)
    - `status` 'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'PENDING_SETTLEMENT' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
    - `trades` object — Map of market to trade details

## Other responses

- `400` — Bad Request

## Changes

- **2026-07-22** `48fe202ea888` — 2 warning, 2 info
  - added the new `UNWIND_TRANSFER` enum value to the `allOf[subschema #2]/results/items/trades/additionalProperties/maker_fill/allOf[#/components/schemas/responses.FillResult]/fill_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
  - added the new `UNWIND_TRANSFER` enum value to the `allOf[subschema #2]/results/items/trades/additionalProperties/taker_fill/allOf[#/components/schemas/responses.FillResult]/fill_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/trades/additionalProperties/maker_fill/allOf[#/components/schemas/responses.FillResult]/fill_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/trades/additionalProperties/taker_fill/allOf[#/components/schemas/responses.FillResult]/fill_type/allOf[#/components/schemas/responses.FillType]/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/block-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)