---
title: "Get block trade offers"
method: GET
path: "/block-trades/{block_trade_id}/offers"
tags: ["BlockTrades"]
---

# Get block trade offers

`GET /block-trades/{block_trade_id}/offers`

## Request

- Base URL: `https://api.prod.paradex.trade/v1`
- URL: `https://api.prod.paradex.trade/v1/block-trades/{block_trade_id}/offers`
- Auth: API key in header `Authorization`

Get all offers for a specific block trade.

Returns all offers submitted for a parent block trade by required signers.

**Access:** Available to initiator, required signers,
or accounts with submitted offers.

**Returns:** Array of offers with:
- Offer ID and parent block trade reference
- Offering account and trade details per market
- Execution signatures and timestamps
- Current offer state and execution details

## Path parameters

- `block_trade_id` string, required

## Response `200`

OK

- object
  - `results` object[]: Array of 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' | 'EXECUTING' | 'PENDING_SETTLEMENT' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
    - `trades` object: Map of market to trade details

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-10-22** `f33feb7333ea`: 6 warning
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
  - …2 more
- **2026-10-22** `ed1654c95ef8`: 1 info
  - removed the `READY_TO_EXECUTE` enum value from the `allOf[subschema #2]/results/items/status/allOf[#/components/schemas/responses.BlockTradeStatus]/` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/block-trades/:block_trade_id/offers/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.dev/tradeparadex/apis/paradex-rest-api-2/revisions/f33feb7333ea?raw)