Add Order

Description

This endpoint allows users to place orders via WebSocket.

WS Request

For each request, the json body structure is

{
    "id": "759ad5add86b4b09b35145a4d6f49488",
    "op": "uta.order",
    "args": {}
}

Note

If your account is in UTA mode, then op must be used in conjunction with uta.order and uta.cancel for placing and canceling orders, and you need to specify in the request body whether it's for spot or contract trading. In other words, orders placed under uta.order cannot be canceled by spot.cancel.

Data Schema

addOrderRequest

WS Request Example

op - uta.order

For more order request examples, please refer to the corresponding endpoint page in the online REST API documentation.

WS Response

For successful response, the json body structure is

{
    "code": "200000",
    "data": {
        "clientOid": "ae0a3849999a498ead7ac5e721a271e0d5fa80cd",
        "orderId": "403004610618449920",
        "tradeType": "FUTURES",
        "ts": 1768896988635000000
    },
    "id": "07910d5513a24fcea60d41e575c641a3",
    "inTime": 1768896988634568000,  // ms or ns
    "op": "uta.order",
    "outTime": 1768896988636220000, // ms or ns
    "userRateLimit": {
        "limit": 2000,
        "remaining": 1999,
        "reset": 14406
    }
}

Data Schema

addOrderResponse

WS Response Example

UTA Futures

Exception Example

1. Connection

An Error occurs during connection.

{
    "code":"400003",
    "msg":"KC-API-KEY not exists.",
    "inTime":1741589088843,
    "outTime":1741589088848
}

2. Parameter Validation

3. Rate Limit

4. Place Order

WS Request#

Data Schema#

WS Request Example#

WS Response#

Data Schema#

WS Response Example#

Exception Example#

Request

WS Request

Data Schema

WS Request Example

WS Response

Data Schema

WS Response Example

Exception Example