Production API ReferenceBlock Trades

Execute individual offer

Execute a specific offer independently of the parent block trade.

Executes an individual offer without waiting for full block trade execution.

Requirements:

  • Called by authorized account (initiator, offering account, or required signer)
  • Valid signatures from all required parties
  • Unexpired signatures and executable offer state

Independent Execution:

  • Processes only the specific offer’s trades
  • Does not require other offers to be ready
  • Executes all trades in the offer together

Returns: Executed offer with status, fill details, timestamps, and updated balances.

Path parameters

block_trade_idstringRequired
Parent Block Trade ID
offer_idstringRequired
Offer ID

Request

Offer execution parameters
execution_noncestringRequired
Unique nonce for this execution request
signaturesmap from strings to objectsRequired
Map of offer IDs to initiator signatures accepting each offer. Block id if it is a direct block trade.
selected_offerslist of stringsOptional

Array of offer IDs selected for execution (offers are atomic, not partial)

Response

OK
block_expirationinteger or null
Unix timestamp in milliseconds when block expires
block_idstring or null

Backend-generated unique identifier

block_typeenum or null
Block type
Allowed values:
created_atinteger or null
When block was created
initiatorstring or null
Account that initiated this block trade
last_updated_atinteger or null
When block was last updated
noncestring or null
Original block nonce
parent_block_idstring or null

Parent block ID (if offer-based)

required_signerslist of strings or null
List of accounts that can participate in the block trade
signaturesmap from strings to objects or null

Current signatures on this block (for signature verification)

statusenum or null
Current status of the block trade
tradesmap from strings to objects or null
Map of market to trade details

Errors