Create block trade offer | Paradex

curl -X POST https://api.prod.paradex.trade/v1/block-trades/block_trade_id/offers \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "nonce": "98765",
  "offering_account": "0xabcdef1234567890",
  "signature": {
    "nonce": "12345",
    "signature_data": "0xabc123...",
    "signature_expiration": 1640995800000,
    "signature_timestamp": 1640995200000,
    "signature_type": "STARKNET",
    "signer_account": "0x1234567890abcdef"
  },
  "trades": {}
}'

{
  "block_expiration": 1640995800000,
  "block_id": "block_456",
  "block_type": "OFFER_BASED",
  "created_at": 1640995200000,
  "initiator": "0x123...abc",
  "last_updated_at": 1640995400000,
  "nonce": "67890",
  "parent_block_id": "block_123",
  "required_signers": [
    "string"
  ],
  "signatures": {},
  "status": "COMPLETED",
  "trades": {}
}

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.

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.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

block_trade_idstringRequired

Parent Block Trade ID

Request

Block offer content

noncestringRequired

Unique nonce for this offer request

offering_accountstringRequired

Starknet address of the account making this offer

signatureobjectRequired

Cryptographic signature authorizing this offer

tradesmap from strings to objectsRequired

Map of market symbol to offer details

Response

Created

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