For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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.
