Create order

POST

Open a new order

Request

This endpoint expects an object.
instructionstringRequired

Order Instruction, GTC, IOC or POST_ONLY if empty GTC

marketstringRequired

Market for which order is created

pricestringRequired

Order price

side"BUY" or "SELL"Required
Allowed values: BUYSELL

Order side

signaturestringRequired

Order Payload signed with STARK Private Key

signature_timestampintegerRequired

Timestamp 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

flagslist of "REDUCE_ONLY"Optional

Order flags, allow flag: REDUCE_ONLY

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

Response

Created

accountstringOptional

Account identifier (user’s account address)

avg_fill_pricestringOptional

Average fill price of the order

cancel_reasonstringOptional

Reason for order cancellation if it was closed by cancel

client_idstringOptional

Client id passed on order creation

created_atintegerOptional

Order creation time

flagslist of "REDUCE_ONLY"Optional

Order flags, allow flag: REDUCE_ONLY

idstringOptional

Unique order identifier

instructionenumOptional
Allowed values: GTCPOST_ONLYIOC

OrderInstruction (GTC, IOC, POST_ONLY)

last_updated_atintegerOptional

Order last update time. No changes once status=CLOSED

marketstringOptional

Market to which order belongs

pricestringOptional

Order price. 0 for MARKET orders

published_atintegerOptional

Order published to the client time

received_atintegerOptional

Order received from the client time

remaining_sizestringOptional

Remaining size of the order

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.

side"BUY" or "SELL"Optional
Allowed values: BUYSELL

Order side

sizestringOptional

Order size

statusenumOptional
Allowed values: NEWUNTRIGGEREDOPENCLOSED

Order status

stpenumOptional
Allowed values: EXPIRE_MAKEREXPIRE_TAKEREXPIRE_BOTH

Self Trade Prevention mode (EXEPIRE_MAKER, EXPIRE_TAKER, EXPIRE_BOTH)

timestampintegerOptional

Order signature timestamp

trigger_pricestringOptional

Trigger price for stop order

typeenumOptional

Order type

Errors