Create order
Limit: 10 requests per 1 second
POST /v1/order
Place order maker/taker, the order executed information will be update from websocket stream. will response immediately with an order created message.
MARKET type order behavior: it matches until the full size is executed. If the size is too large (larger than whole book) or the matching price exceeds the price limit (refer to price_range), then the remaining quantity will be cancelled.
IOC type order behavior: it matches as much as possible at the order_price. If not fully executed, then remaining quantity will be cancelled.
FOK type order behavior: if the order can be fully executed at the order_price then the order gets fully executed otherwise would be cancelled without any execution.
POST_ONLY type order behavior: if the order will be executed with any maker trades at the time of placement, then it will be cancelled without any execution.
ASK type order behavior: the order price is guranteed to be the best ask price of the orderbook at the time it gets accepted.
BID type order behavior: the order price is guranteed to be the best bid price of the orderbook at the time it gets accepted.
visible_quantity behavior: it sets the maximum quantity to be shown on orderbook. By default, it is equal to order_quantity, negative number and number larger than order_quantity is not allowed. If it sets to 0, the order would be hidden from the orderbook. It doesn’t work for MARKET/IOC/FOK orders since orders with these types would be executed and cancelled immediately and not be shown on orderbook. For LIMIT order, as long as it’s not complete, visible_quantity is the maximum quantity that shown on orderbook.
order_quantity are provided. The precision of the number should be within 8 digits.
client_order_id behavior: customized order_id, a unique id among open orders. Orders with the same client_order_id can be accepted only when the previous one if completed, otherwise the order will be rejected.
Note: This endpoint requires trading scope in orderly key.
Headers
Timestamp of the signed request in milliseconds.
Account ID of the authenticated account.
Public orderly key used to sign the request.
Signature of the request payload generated with the orderly key.
Use this parameter to control the timeout threshold for placing order, unit in miliseconds
Body
"PERP_ETH_USDC"
LIMIT/MARKET/IOC/FOK/POST_ONLY/ASK/BID
SELL/BUY
36 length, accepts hyphen but cannot be the first character, default: null
If order_type is MARKET/ASK/BID, then is not required, otherwise this parameter is required.
For MARKET/ASK/BID order, the order size in terms of quote currency
The order quantity shown on orderbook. (default: equal to order_quantity) Visible quantity is not supported for post-only orders.
Default false
MARKET orders beyond this slippage will not be executed
Integer value from 0 to 4. This parameter controls wether to present the price of bid0 to bid4 or ask0 to ask4. Only allowed when order_type is BID or ASK.
If set to true, then price will be adjusted to 1 tick close to current best price. Only supported for POST_ONLY type orders
Margin mode for the order. Default: the symbol's current default margin mode.
CROSS, ISOLATED