Skip to main content

Get Order Info

Frequency limit: 20 times/1s (UID)

Description

Get Order Info

If you query the order details through clientOid, the following requirements need to be met:

  • clientOid is customized by user, not our system-generated
  • the order is in unfilled status

HTTP Request

  • GET /api/v2/spot/trade/orderInfo
Request Example
curl "https://api.cointr.com/api/v2/spot/trade/orderInfo?orderId=1234567890" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

Request Parameter

ParameterTypeRequiredDescription
orderIdStringNoEither Order ID or clientOids is required.
clientOidStringNoEither Client customized ID or orderId is required.
requestTimeStringNorequest Time Unix millisecond timestamp
receiveWindowStringNovalid window period Unix millisecond timestamp Unix millisecond timestamp
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1684492945476,
"data": [
{
"userId": "**********",
"symbol": "TRXUSDT",
"orderId": "121211212122",
"clientOid": "1-2-1-2-1",
"price": "0",
"size": "10.0000000000000000",
"orderType": "market",
"side": "buy",
"status": "filled",
"priceAvg": "0.0699782527055350",
"baseVolume": "142.9015000000000000",
"quoteVolume": "9.9999972790000000",
"enterPointSource": "API",
"feeDetail": "{\"newFees\":{\"c\":0,\"d\":0,\"deduction\":false,\"r\":-0.112079256,\"t\":-0.112079256,\"totalDeductionFee\":0},\"USDT\":{\"deduction\":false,\"feeCoinCode\":\"TRX\",\"totalDeductionFee\":0,\"totalFee\":-0.1120792560000000}}",
"orderSource": "market",
"quoteCoin": "USDT",
"baseCoin": "BTC",
"cTime": "1690196141868",
"uTime": "1690196141868"
}
]
}

Response Parameter

ParameterTypeDescription
userIdStringAccount id
symbolStringTrading pair name
orderIdStringOrder ID
clientOidStringCustomized ID
priceStringOrder price
sizeStringAmount
Limit represents the number of base coins.
market-buy represents the number of quote coins.
market-sell represents the number of base coins.
orderTypeStringOrder type
limit Limit price
market Market price
sideStringDirection
statusStringOrder status
init Initialize
live pending match
new Unfilled, waiting for a match
partially_filled Partially filled
filled All filled
cancelled The order is cancelled
priceAvgStringFilled price
baseVolumeStringFilled quantity (base coin)
quoteVolumeStringTotal trading amount (quote coin)
enterPointSourceStringClient
WEB WEB Client
APP APP Client
API API Client
SYS SYS Client
ANDROID ANDROID Client
IOS IOS Client
cTimeStringCreation time, Unix millisecond timestamp, e.g. 1690196141868
uTimeStringUpdate time, Unix millisecond timestamp, e.g. 1690196141868
baseCoinStringLeft coin
quoteCoinStringRight coin
orderSourceStringOrder source
normal Normal order
market Market order
feeDetailStringTransaction fee breakdown
> newFeesStringFee details for "newFees".
>> cStringAmount deducted by coupons, unit:currency obtained from the transaction.
>> dStringAmount deducted in PLATSK (Cointr Coin), unit:PLATSK
>> rStringIf the PLATSK balance is insufficient to cover the fees, the remaining amount is deducted from the currency obtained from the transaction.
>> tStringThe total fee amount to be paid, unit :currency obtained from the transaction.
>> deductionStringIgnore.
>> totalDeductionFeeStringIgnore.
> PLATSKStringIf there is no "newFees" field, this data represents earlier historical data. This key represents the currency used for fee deduction (it is not fixed; if PLATSK deduction is enabled, it's PLATSK, otherwise, it's the currency obtained from the transaction).
>> deductionStringWhether there is a fee deduction.
>> feeCoinCodeStringTransaction fee coin code
>> totalDeductionFeeStringDeduction amount unit: PLATSK
>> totalFeeStringThe total fee amount to be paid, unit:currency obtained from the transaction.