Get block trade | Paradex

Retrieve a specific block trade by ID with full details. Returns complete block trade information including status, trade details, signatures, and offers. **Access:** Available to initiator, required signers, or accounts with submitted offers. **Returns:** - Block ID and status (CREATED, OFFER_COLLECTION, READY_TO_EXECUTE, EXECUTING, COMPLETED, CANCELLED) - Market-specific trade details with orders and fill information - All collected signatures from required signers - Creation time, last update, expiration, and participant information

Retrieve a specific block trade by ID with full details.

Returns complete block trade information including status, trade details, signatures, and offers.

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

Returns:

Block ID and status (CREATED, OFFER_COLLECTION, READY_TO_EXECUTE, EXECUTING, COMPLETED, CANCELLED)
Market-specific trade details with orders and fill information
All collected signatures from required signers
Creation time, last update, expiration, and participant information

Authentication

Authorizationstring

API Key authentication via header

Path parameters

block_trade_idstringRequired

Block Trade ID

Response

block_expirationinteger

Unix timestamp in milliseconds when block expires

block_idstring

Backend-generated unique identifier

block_typeenum

Block type

Allowed values:

created_atinteger

When block was created

initiatorstring

Account that initiated this block trade

last_updated_atinteger

When block was last updated

noncestring

Original block nonce

parent_block_idstring

Parent block ID (if offer-based)

required_signerslist of strings

List of accounts that can participate in the block trade

signaturesmap from strings to objects

Current signatures on this block (for signature verification)

statusenum

Current status of the block trade

tradesmap from strings to objects

Map of market to trade details

Errors

400

Bad Request Error

404

Not Found Error