Create Order

​

Unique Client Request ID

For the current WebSocket request, you can optionally include a unique client request ID in the request body. The same client request ID will be found in the response and is used to match the response to the request. The client request ID must be a UUID.

​

Cross-Leverage Multiplier

We use a cross-leverage approach in our trading platform. This means leverage is applied at the account level rather than the trade level. As a result, if you use leverage on one open position, the same leverage must be applied to all subsequent positions until they are closed and open orders are cancelled.

Please note that leverage must be specified in the create order request to ensure the correct leverage is applied. If the leverage value provided differs from the one currently set on the account, the order will be rejected. We recognize that this behavior may be a bit confusing, and we plan to introduce a separate endpoint in the future that will allow setting leverage at the account level.

​

Acknowledgment And Confirmation

When you place an order, you will first receive a response to acknowledge that the request has been received. Then you will receive another response to confirm that the order has been successfully created.

There are three differences between these two responses:

​

Post-Only Option For Limit Orders

When placing a limit order, you can choose to set the postOnly option to true or false. By default, this option is set to false, which means the order may match with an existing order in the order book and you may become the taker. We provide a post-only option for limit orders. When this option is set to true, the order will only be placed if it does not match with an existing order in the order book.

Using post-only orders will ensure that you are always the maker and never the taker.

If the order would match with an existing order, you will first receive the normal Acknowledgment and Confirmation responses, followed by a 400 response with resultType: rejectOrder.

For more details, refer to ourOrder Rejected Notifications

​

Receive Window

To ensure that your requests are processed in a timely manner, we enforce a receive window of 1 second for all create order requests. If the request is not processed within this time frame, it will be rejected with a 400 status code and an error message receive window exceeded, order rejected indicating that the request has timed out. The order status in the response will be set to rejected. You can then retry the request with a new clientRequestId.

​

URL

​

Query params

​

Headers

See Authorization section on how to retrieve authorization token. Once token is received, set Sec-WebSocket-Protocol headers in the WebSocket handshake request or on connect().

authorization#eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdGFnaW5nLmZ1bmdpYmxlLnh5eiIsInN1YiI6ImQxM2I1MzBmLWFmNzMtNDBmOS04ZjhlLWVkNzk1OTU3YTU3ZiIsImF1ZCI6WyJzdGFnaW5nLWFwcC5mdW5naWJsZS54eXoiXSwiZXhwIjoxNzAzMzA1NzQwLCJpYXQiOjE3MDMzMDM5NDB9.vsHe4G_yEkRfz8XNoTKcX83udA-LUysWD4q80wfCC8k

// Note that both clientRequestId and leverage are optional
{
  "message": "createOrder",
  "content": {
    "clientRequestId": "0835bf3e-4a20-41f0-908d-8213f2b7a285",
    "price": "2000.90",
    "quantity": "1.00",
    "orderType": "buy",
    "tradeType": "limit",
    "leverage": "1",
    "postOnly": false // Optional
  }
}

// Request received successfully
{
  "resultType": "createOrder",
  "data": {
    "statusCode": 202,
    "body": "order created, pending acceptance",
    "order": {
        "userId": "1cf96e01-fa22-4b3a-8dff-599d1cb45c78",
        "orderId": "01HZ5J70FCBNJAS7TVPVB4GAAG",
        "market": "ETH-USD",
        "orderType": "buy",
        "tradeType": "limit",
        "orderStatus": "pending",
        "price": "3600",
        "quantity": "1",
        "filledQuantity": "0",
        "leverage": "1",
        "updatedAt": 1746642892940,
        "createdAt": 1746642892940,
        "reduceOnly": false,
        "postOnly": true
    },
    "clientRequestId": "0835bf3e-4a20-41f0-908d-8213f2b7a285"
  },
  "connectionId": "KNal9ekeCYcCIBA="
}