v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03113163377.5 KB

BlockTrades

Create block trade offer

Create a sub-block offer for an existing block trade.

Required signers submit their order details and pricing for markets defined in the parent block trade.

Requirements:

Account must be listed as required signer with active onboarding
Valid order signatures for all markets
Orders must match parent block trade constraints

Includes:

Individual order signatures per market
Block trade execution signature with expiration
Proper nonce and signature verification data

Returns the created offer with unique ID, parent reference, and order details.

post/block-trades/{block_trade_id}/offers

Path parameters

block_trade_idstring required

Parent Block Trade ID

Request body

noncestring required

Unique nonce for this offer request

offering_accountstring required

Starknet address of the account making this offer

tradesobject required

Map of market symbol to offer details

Example request

{
  "nonce": "98765",
  "offering_account": "0xabcdef1234567890",
  "signature": {
    "nonce": "12345",
    "signature_data": "0xabc123...",
    "signature_expiration": 1640995800000,
    "signature_timestamp": 1640995200000,
    "signature_type": "STARKNET",
    "signer_account": "0x1234567890abcdef",
    "signer_public_key": "0xabc..."
  }
}

Response

Created

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

failure_reasonstring

Reason for failure (if status is FAILED)

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"
}