Create block trade | Paradex

Create a parent block trade for multi-party execution. Block trades coordinate execution across multiple parties. The initiator creates a parent block trade specifying trade details and required signers, who must submit offers before execution. **Requirements:** - Required signers must have active onboarding and block trade functionality - Valid StarkNet signature with expiration timestamp - Each trade specifies market, size, price, and order details **Workflow:** 1. Initiator creates parent block trade 2. Required signers submit offers 3. Initiator executes with selected offers 4. All trades processed together

Create a parent block trade for multi-party execution.

Block trades coordinate execution across multiple parties. The initiator creates a parent block trade specifying trade details and required signers, who must submit offers before execution.

Requirements:

Required signers must have active onboarding and block trade functionality
Valid StarkNet signature with expiration timestamp
Each trade specifies market, size, price, and order details

Workflow:

Initiator creates parent block trade
Required signers submit offers
Initiator executes with selected offers
All trades processed together

Authentication

Authorizationstring

API Key authentication via header

Request

Block trade content

block_expirationintegerRequired

Unix timestamp in milliseconds when block expires

noncestringRequired

Unique nonce for this block trade request

required_signerslist of stringsRequired

List of accounts that can participate in the block trade

signaturesmap from strings to objectsRequired

Map of account addresses to their signatures. Can be empty or partial.

tradesmap from strings to objectsRequired

Map of market symbol to trade info (one per market)

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

Create a parent block trade for multi-party execution.

Block trades coordinate execution across multiple parties. The initiator creates a parent block trade specifying trade details and required signers, who must submit offers before execution.

Requirements:

Required signers must have active onboarding and block trade functionality
Valid StarkNet signature with expiration timestamp
Each trade specifies market, size, price, and order details

Workflow:

Initiator creates parent block trade
Required signers submit offers
Initiator executes with selected offers
All trades processed together

API Key authentication via header

Unix timestamp in milliseconds when block expires

Unique nonce for this block trade request

List of accounts that can participate in the block trade

Map of account addresses to their signatures. Can be empty or partial.

Map of market symbol to trade info (one per market)

Unix timestamp in milliseconds when block expires

Backend-generated unique identifier

When block was created

Account that initiated this block trade

When block was last updated

Original block nonce

Parent block ID (if offer-based)

List of accounts that can participate in the block trade

Current signatures on this block (for signature verification)

Current status of the block trade

Map of market to trade details

$	curl -X POST https://api.testnet.paradex.trade/v1/block-trades \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"block_expiration": 1640995800000,
>	"nonce": "67890",
>	"required_signers": [
>	"string"
>	],
>	"signatures": {},
>	"trades": {}
>	}'

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	}

$	curl -X POST https://api.testnet.paradex.trade/v1/block-trades \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"block_expiration": 1640995800000,
>	"nonce": "67890",
>	"required_signers": [
>	"string"
>	],
>	"signatures": {},
>	"trades": {}
>	}'

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	}