Execute individual offer

POST

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

Execute a specific offer independently of the parent block trade.

Executes an individual offer without waiting for full block trade execution.

Requirements:

Called by authorized account (initiator, offering account, or required signer)
Valid signatures from all required parties
Unexpired signatures and executable offer state

Independent Execution:

Processes only the specific offer’s trades
Does not require other offers to be ready
Executes all trades in the offer together

Returns: Executed offer with status, fill details, timestamps, and updated balances.

Execute a specific offer independently of the parent block trade. Executes an individual offer without waiting for full block trade execution. **Requirements:** - Called by authorized account (initiator, offering account, or required signer) - Valid signatures from all required parties - Unexpired signatures and executable offer state **Independent Execution:** - Processes only the specific offer's trades - Does not require other offers to be ready - Executes all trades in the offer together **Returns:** Executed offer with status, fill details, timestamps, and updated balances.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

block_trade_idstringRequired

Parent Block Trade ID

offer_idstringRequired

Offer ID

Request

Offer 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/offers/offer_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	}