v50

latestOpenAPI 3.0.1raw.githubusercontent.com2026-03-2591124300.0 KB

BlockTrades

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.

post/block-trades/{block_trade_id}/offers/{offer_id}/execute

Path parameters

block_trade_idstring required

Parent Block Trade ID

offer_idstring required

Offer ID

Request body

execution_noncestring required

Unique nonce for this execution request

selected_offersstring[]

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

signaturesobject required

Map of offer IDs to initiator signatures accepting each offer. Block id if it is a direct block trade.

Example request

{
  "execution_nonce": "execution_001"
}

Response

block_expirationinteger

Unix timestamp in milliseconds when block expires

block_idstring

Backend-generated unique identifier

block_type'DIRECT' | 'OFFER_BASED'

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_signersstring[]

List of accounts that can participate in the block trade

signaturesobject

Current signatures on this block (for signature verification)

tradesobject

Map of market to trade details

Example response

{
  "block_expiration": 1640995800000,
  "block_id": "block_456",
  "created_at": 1640995200000,
  "initiator": "0x123...abc",
  "last_updated_at": 1640995400000,
  "nonce": "67890",
  "parent_block_id": "block_123"
}