Get Order By ClientOid

GET

https://api.kucoin.com/api/v3/hf/margin/orders/client-order/{clientOid}

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

sdk-service:Margin

sdk-sub-service:Order

sdk-method-name:getOrderByClientOid

api-rate-limit-weight:5

Description

This endpoint can be used to obtain information for a single Margin order using the client order ID.

After the user successfully places an order, the order is in the Active state, and the user can use inOrderBook to determine whether the order has entered the order. Canceled or fully filled orders are marked as completed Done status.

Tips

If the order is not an active order, you can only get data within the time range of 7 * 24 hours (i.e.: from the current time to 7 * 24 hours ago). If the time range is exceeded, the system will query the data within the time range of 7 * 24 hours by default.

Request

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.kucoin.com/api/v3/hf/margin/orders/client-order/5c52e11203aa677f33e493fb?symbol=BTC-USDT'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "id": "671667306afcdb000723107f",
        "symbol": "BTC-USDT",
        "opType": "DEAL",
        "type": "limit",
        "side": "buy",
        "price": "50000",
        "size": "0.00001",
        "funds": "0.5",
        "dealSize": "0",
        "dealFunds": "0",
        "fee": "0",
        "feeCurrency": "USDT",
        "stp": null,
        "stop": null,
        "stopTriggered": false,
        "stopPrice": "0",
        "timeInForce": "GTC",
        "postOnly": false,
        "hidden": false,
        "iceberg": false,
        "visibleSize": "0",
        "cancelAfter": 0,
        "channel": "API",
        "clientOid": "5c52e11203aa677f33e493fb",
        "remark": null,
        "tags": null,
        "cancelExist": false,
        "createdAt": 1729521456248,
        "lastUpdatedAt": 1729651011877,
        "tradeType": "MARGIN_TRADE",
        "inOrderBook": true,
        "cancelledSize": "0",
        "cancelledFunds": "0",
        "remainSize": "0.00001",
        "remainFunds": "0.5",
        "tax": "0",
        "active": true,
        "cancelReason": 0
    }
}

Modified at 2025-11-18 08:50:27

Get Order By OrderId

Add Stop Order