Production API ReferenceBlock Trades

Get specific block trade offer

Get a specific offer by ID for a block trade. Retrieves detailed information about an offer submitted for a parent block trade. **Access:** Available to initiator, required signers, or the offering account. **Returns:** - Offer ID and parent block trade reference - Market-specific order information with pricing/sizing - StarkNet signatures and verification data - Execution status and timestamps

Authentication

Authorizationstring
API Key authentication via header

Path parameters

block_trade_idstringRequired
Parent Block Trade ID
offer_idstringRequired
Offer ID

Response

OK
block_expirationinteger
Unix timestamp in milliseconds when block expires
block_idstring

Backend-generated unique identifier

block_typeenum
Block type
Allowed values:
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_signerslist of strings
List of accounts that can participate in the block trade
signaturesmap from strings to objects

Current signatures on this block (for signature verification)

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

Errors

400
Bad Request Error
404
Not Found Error