Get Order By ClientOid

Description

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

After the user successfully places an order, the order is in 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 (ie: 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.

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

string

required

The unique order id generated by the trading system

clientOid

string

required

Client Order Id，unique identifier created by the user

symbol

string

required

symbol

Examples:

BTC-USDTETH-USDTKCS-USDT

opType

string

required

type

enum<string>

required

Specify if the order is an 'limit' order or 'market' order.

Allowed values:

limitmarket

side

enum<string>

required

Buy or sell

Allowed values:

buysell

price

string

required

Order price

size

string

required

Order size

funds

string

required

Order Funds

dealSize

string

required

Number of filled transactions

dealFunds

string

required

Funds of filled transactions

cancelledSize

string

required

Number of canceled transactions

cancelledFunds

string

required

Funds of canceled transactions

remainSize

string

required

Number of remain transactions

remainFunds

string

required

Funds of remain transactions

fee

string

required

Handling fees

feeCurrency

string

required

currency used to calculate trading fee

stp

enum<string>

optional

Self Trade Prevention

Allowed values:

DCCOCNCB

timeInForce

enum<string>

required

Time in force

Allowed values:

GTCGTTIOCFOK

postOnly

boolean

required

Whether its a postOnly order.

hidden

boolean

required

Whether its a hidden order.

iceberg

boolean

required

Whether its a iceberg order.

visibleSize

string

required

Visible size of iceberg order in order book.

cancelAfter

integer <int64>

required

A GTT timeInForce that expires in n seconds

channel

string

required

remark

string

optional

Order placement remarks

tags

string

optional

Order tag

cancelExist

boolean

required

Whether there is a cancellation record for the order.

tradeType

string

required

Trade type, redundancy param

inOrderBook

boolean

required

Whether to enter the orderbook: true: enter the orderbook; false: not enter the orderbook

active

boolean

required

Order status: true-The status of the order isactive; false-The status of the order is done

tax

string

required

Users in some regions need query this field

createdAt

integer <int64>

required

lastUpdatedAt

integer <int64>

required

Example

{
  "code": "200000",
  "data": {
    "id": "6717422bd51c29000775ea03",
    "clientOid": "5c52e11203aa677f33e493fb",
    "symbol": "BTC-USDT",
    "opType": "DEAL",
    "type": "limit",
    "side": "buy",
    "price": "70000",
    "size": "0.00001",
    "funds": "0.7",
    "dealSize": "0.00001",
    "dealFunds": "0.677176",
    "remainSize": "0",
    "remainFunds": "0.022824",
    "cancelledSize": "0",
    "cancelledFunds": "0",
    "fee": "0.000677176",
    "feeCurrency": "USDT",
    "stp": null,
    "timeInForce": "GTC",
    "postOnly": false,
    "hidden": false,
    "iceberg": false,
    "visibleSize": "0",
    "cancelAfter": 0,
    "channel": "API",
    "remark": "order remarks",
    "tags": null,
    "cancelExist": false,
    "tradeType": "TRADE",
    "inOrderBook": false,
    "active": false,
    "tax": "0",
    "createdAt": 1729577515444,
    "lastUpdatedAt": 1729577515481
  }
}

Get Order By ClientOid

Request

Request samples

Responses