Create block trade offer

POST

https://api.prod.paradex.trade/v1/block-trades/:block_trade_id/offers

POST

/v1/block-trades/:block_trade_id/offers

$ 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": {}
> }'

1 {
2   "block_expiration": 1640995800000,
3   "block_id": "block_456",
4   "block_type": "OFFER_BASED",
5   "created_at": 1640995200000,
6   "failure_reason": "string",
7   "initiator": "0x123...abc",
8   "last_updated_at": 1640995400000,
9   "nonce": "67890",
10   "parent_block_id": "block_123",
11   "required_signers": [
12     "string"
13   ],
14   "signatures": {},
15   "status": "COMPLETED",
16   "trades": {}
17 }

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_expirationintegerOptional

Unix timestamp in milliseconds when block expires

block_idstringOptional

Backend-generated unique identifier

block_typeenumOptional

Block type

created_atintegerOptional

When block was created

failure_reasonstringOptional

Reason for failure (if status is FAILED)

initiatorstringOptional

Account that initiated this block trade

last_updated_atintegerOptional

When block was last updated

noncestringOptional

Original block nonce

parent_block_idstringOptional

Parent block ID (if offer-based)

required_signerslist of stringsOptional

List of accounts that can participate in the block trade

signaturesmap from strings to objectsOptional

Current signatures on this block (for signature verification)

statusenumOptional

Current status of the block trade

tradesmap from strings to objectsOptional

Map of market to trade details

Errors

400

Bad Request Error

404

Not Found Error