Execute block trade

POST

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

Execute a block trade with selected offers.

Executes a parent block trade by selecting specific offers from required signers.

Requirements:

Called by block trade initiator
All selected offers must have valid, unexpired signatures
Required signers must have submitted offers for all markets
Block trade must be in READY_TO_EXECUTE state

Execution Process:

All trades processed together
Creates fills and updates balances upon success
Participants receive fill notifications

Returns: Executed block trade with status (COMPLETED/FAILED), fill details, timestamps, and settlement info.

Execute a block trade with selected offers. Executes a parent block trade by selecting specific offers from required signers. **Requirements:** - Called by block trade initiator - All selected offers must have valid, unexpired signatures - Required signers must have submitted offers for all markets - Block trade must be in READY_TO_EXECUTE state **Execution Process:** - All trades processed together - Creates fills and updates balances upon success - Participants receive fill notifications **Returns:** Executed block trade with status (COMPLETED/FAILED), fill details, timestamps, and settlement info.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

block_trade_idstringRequired

Block Trade ID

Request

Block execution parameters

execution_noncestringRequired

Unique nonce for this execution request

signaturesmap from strings to objectsRequired

Map of offer IDs to initiator signatures accepting each offer. Block id if it is a direct block trade.

selected_offerslist of stringsOptional

Array of offer IDs selected for execution (offers are atomic, not partial)

Response

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

$	curl -X POST https://api.prod.paradex.trade/v1/block-trades/block_trade_id/execute \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"execution_nonce": "execution_001",
>	"signatures": {}
>	}'

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	}