Production API ReferenceOrders

Create order

Submits a new order to Paradex. Returns an order status object with a unique order `id` assigned by Paradex. This order `id` serves as the primary identifier for the order. The REST API performs basic validation and queues the order for risk checks (order `status`=`NEW`). Once validation and risk checks are successful, the order is sent to the matching engine. The matching engine processes the order and updates the status to `OPEN` if the order is resting. If the order is fully filled or cannot be processed, the status changes to `CLOSED` and a `cancel_reason` code is provided (e.g., fully filled or no liquidity).

Authentication

Authorizationstring
API Key authentication via header

Request

Order content
instructionenumRequired

Order Instruction, GTC, IOC, RPI or POST_ONLY if empty GTC

Allowed values:
marketstringRequired
Market for which order is created
pricestringRequired
Order price
sideenumRequired
Order side
Allowed values:
signaturestringRequired

Order signature in as a string “[r,s]” signed by account’s paradex private key

signature_timestampintegerRequired
Unix timestamp in milliseconds of order creation, used for signature verification
sizestringRequired
Size of the order
typeenumRequired
Order type
client_idstringOptional<=64 characters
Unique client assigned ID for the order
dime_discountbooleanOptional

If true, fees are charged in DIME with the DIME discount applied; falls back to USDC if balance is insufficient

flagslist of enumsOptional

Order flags, allow flag: REDUCE_ONLY

on_behalf_of_accountstringOptional
ID corresponding to the configured isolated margin account. Only for isolated margin orders
recv_windowintegerOptional
Order will be created if it is received by API within RecvWindow milliseconds from signature timestamp, minimum is 10 milliseconds
stpstringOptional

Self Trade Prevention, EXPIRE_MAKER, EXPIRE_TAKER or EXPIRE_BOTH, if empty EXPIRE_TAKER

trigger_pricestringOptional
Trigger price for stop order
vwap_pricestringOptional
Optional VWAP price for market orders used for VWAP instruction, bounded by price band

Response

Created
accountstringOptional
Paradex Account
avg_fill_pricestringOptional
Average fill price of the order
cancel_reasonstringOptional
Reason for order cancellation if it was closed by cancel
client_idstringOptional
Client order id provided by the client at order creation
created_atintegerOptional
Order creation time
flagslist of enumsOptional

Order flags, allow flag: REDUCE_ONLY

idstringOptional
Unique order identifier generated by Paradex
instructionenumOptional
Execution instruction for order matching
Allowed values:
last_updated_atintegerOptional

Order last update time. No changes once status=CLOSED

marketstringOptional
Market
pricestringOptional
Order price. 0 for MARKET orders
published_atintegerOptional
Timestamp in milliseconds when order was sent to the client
received_atintegerOptional
Timestamp in milliseconds when order was received by API service
remaining_sizestringOptional
Remaining size of the order
request_infoobjectOptional
Additional request information for orders
seq_nointegerOptional

Unique increasing number (non-sequential) that is assigned to this order update and changes on every order update. Can be used to deduplicate multiple feeds. WebSocket and REST responses use independently generated seq_no per event.

sideenumOptional
Order side
Allowed values:
sizestringOptional
Order size
statusenumOptional
Order status
Allowed values:
stpenumOptional
Self Trade Prevention mode
Allowed values:
timestampintegerOptional
Order signature timestamp
trigger_pricestringOptional
Trigger price for stop order
typeenumOptional
Order type

Errors

400
Bad Request Error