Execute block trade | Paradex

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_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

1	import requests
2
3	url = "https://api.prod.paradex.trade/v1/block-trades/block_trade_id/execute"
4
5	payload = { "execution_nonce": "execution_001" }
6	headers = {
7	"Authorization": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

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