Skip to main content

Trade

API Scopes

Need Permission to view trade information

Trade

Attribute NameTypeDescription
idnumberid of trade
asset_pair_namestringasset pair name
pricestringdeal price
amountstringamount
taker_sidestringorder side, one of "ASK/BID"
sidestringviewer side, one of "ASK/BID/SELF_TRADING"
maker_order_idnumbermaker order id, null if taker_side is equal to side
taker_order_idnumbertaker order id, null if taker_side is not equal to side
maker_feestringmaker fee, null if taker_side is equal to side
taker_feestringtaker fee, null if taker_side is not equal to side
created_atstringcreated time

Trades of user

GET /viewer/trades

Parameters

NameTypeRequireDescriptionExample
asset_pair_namestringtrueasset pair nameBTC-USDT
page_tokenstringfalserequest page after this page token
limitstringfalsedefault 20, max 200

Response is a Trade array.

{
"code": 0,
"data": [
{
"id": 10854280,
"asset_pair_name": "XIN-USDT",
"price": "70",
"amount": "1",
"taker_side": "ASK",
"maker_order_id": 58284908,
"taker_order_id": 58284909,
"maker_fee": "0.0008",
"taker_fee": "0.07",
"side": "SELF_TRADING",
"inserted_at": "2019-04-16T12:00:01Z"
},
{
"id": 10854263,
"asset_pair_name": "XIN-USDT",
"price": "75.7",
"amount": "12.743149",
"taker_side": "BID",
"maker_order_id": null,
"taker_order_id": 58284888,
"maker_fee": null,
"taker_fee": "0.0025486298",
"side": "BID",
"inserted_at": "2019-04-15T06:20:57Z"
}
],
"page_token":"dxfv"
}