---
title: "Create block trade"
method: POST
path: "/block-trades"
tags: ["BlockTrades"]
---

# Create block trade

`POST /block-trades`

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

## Request body

- RequestsBlockTradeRequest
  - `block_expiration` integer, required — Unix timestamp in milliseconds when block expires
  - `nonce` string, required — Unique nonce for this block trade request
  - `required_signers` string[], required — List of accounts that can participate in the block trade
  - `signatures` object, required — Map of account addresses to their signatures. Can be empty or partial.
  - `trades` object, required — Map of market symbol to trade info (one per market)

## Response `201`

Created

- ResponsesBlockTradeDetailFullResponse
  - `block_expiration` integer — Unix timestamp in milliseconds when block expires
  - `block_id` string — Backend-generated unique identifier
  - `block_type` 'DIRECT' | 'OFFER_BASED'
  - `created_at` integer — When block was created
  - `failure_reason` string — Reason for failure (if status is FAILED)
  - `initiator` string — Account that initiated this block trade
  - `last_updated_at` integer — When block was last updated
  - `nonce` string — Original block nonce
  - `parent_block_id` string — Parent block ID (if offer-based)
  - `required_signers` string[] — List of accounts that can participate in the block trade
  - `signatures` object — Current signatures on this block (for signature verification)
  - `status` 'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'PENDING_SETTLEMENT' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
  - `trades` object — Map of market to trade details

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/versions/6a76453d754c/schema)