Production API ReferenceBlock Trades

Get block trade

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

OK
block_expirationintegerOptional
Unix timestamp in milliseconds when block expires
block_idstringOptional

Backend-generated unique identifier

block_typeenumOptional
Block type
created_atintegerOptional
When block was created
failure_reasonstringOptional

Reason for failure (if status is FAILED)

initiatorstringOptional
Account that initiated this block trade
last_updated_atintegerOptional
When block was last updated
noncestringOptional
Original block nonce
parent_block_idstringOptional

Parent block ID (if offer-based)

required_signerslist of stringsOptional
List of accounts that can participate in the block trade
signaturesmap from strings to objectsOptional

Current signatures on this block (for signature verification)

statusenumOptional
Current status of the block trade
tradesmap from strings to objectsOptional
Map of market to trade details

Errors

400
Bad Request Error
404
Not Found Error