Execute block trade
Execute a block trade with selected offers.
Executes a parent block trade by selecting specific offers from required signers.
Requirements:
- Called by block trade initiator
- All selected offers must have valid, unexpired signatures
- Required signers must have submitted offers for all markets
- Block trade must be in READY_TO_EXECUTE state
Execution Process:
- All trades processed together
- Creates fills and updates balances upon success
- Participants receive fill notifications
Returns: Executed block trade with status (COMPLETED/FAILED), fill details, timestamps, and settlement info.
Path parameters
block_trade_id
Block Trade ID
Request
Block execution parameters
execution_nonce
Unique nonce for this execution request
signatures
Map of offer IDs to initiator signatures accepting each offer. Block id if it is a direct block trade.
selected_offers
Array of offer IDs selected for execution (offers are atomic, not partial)
Response
OK
block_expiration
Unix timestamp in milliseconds when block expires
block_id
Backend-generated unique identifier
block_type
Block type
Allowed values:
created_at
When block was created
initiator
Account that initiated this block trade
last_updated_at
When block was last updated
nonce
Original block nonce
parent_block_id
Parent block ID (if offer-based)
required_signers
List of accounts that can participate in the block trade
signatures
Current signatures on this block (for signature verification)
status
Current status of the block trade
trades
Map of market to trade details