---
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)
    - `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

---

[API](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/versions/6a76453d754c/schema)