Sign in

v50

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

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
get/block-trades/{block_trade_id}

Path parameters

block_trade_idstring required

Block Trade ID

Response

OK

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)

status'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
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"
}