Spot Trade Endpoints

New Order

Rate limit rule: 10 requests/1s

HTTP Request new order

• POST /api/spot/v1/trade/orders

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symbol：/products
side	String	Yes	Trade Direction
orderType	String	Yes	Trade Type limit/market
force	String	Yes	Order Type
price	String	No	Limit Order Price
quantity	String	Yes	Amount
clientOrderId	String	No	Client Order ID

Response:

{
    "code":"00000",
    "msg":"success",
    "data":{
        "orderId":"1001",
        "clientOrderId":"hgXjh89AsxleMSw"
    }
}

Response Field

Field	Description
orderId	order id
clientOrderId	client order id

Place Multiple Orders

Rate limit rule: 5 requests/1s

HTTP Request Place Multiple Orders

• POST /api/spot/v1/trade/batch-orders

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symbol: /products
orderList	List	Yes	List of Orders

• orderList Field

Parameters	Type	Required	Description
side	String	Yes	Trade Direction
orderType	String	Yes	Trade Type limit/market
force	String	Yes	Order Type
price	String	No	Limit Order Price
quantity	String	Yes	Amoun
clientOrderId	String	No	Client Order ID

Response:

{
    "code":"00000",
    "msg":"success",
    "data":{
        "resultList":[
            {
                "clientOrderId":"hgXjh89AsxleMSw",
                "orderId":"1001"
            }
        ]
    }
}

Cancel Order

Rate limit rule: 10 requests/1s

HTTP Request Cancel order

• POST /api/spot/v1/trade/cancel-order

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symbol ：/products
orderId	String	Yes	Order id array

Response:

{

  "code":"00000",
   "message":"success",
   "data":"1001"

}

Cancel Multiple Orders

Rate limit rule: 10 request/1s

HTTP Request Cancel multiple orders

• POST /api/spot/v1/trade/cancel-batch-orders

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symbol：/products
orderIds	String[]	Yes	Order id array

Response:

{

  "code":"00000",
   "message":"success",
    "data":[
    "1001",
    "1002"
    ]

}   

Get Order details

Rate limit rule: 10 request/1s

HTTP Request get order details by order id or client order id

• POST /api/spot/v1/trade/orderInfo

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symnol：/products
orderId	String	Yes	Order id
clientOrderId	String	No	Custom order id

Response:

{
  "code":"00000",
  "message":"success",
"data":[{
  "accountId":"10012",
  "symbol":"btcusdt_spbl",
  "orderId":"2222222",
  "clientOrderId":"xxxxxxx",
  "price":"34245.12",
  "quantity":"1",  
  "orderType":"limit",
  "side":"buy",
  "status":"new",
  "fillPrice":"0",
  "fillQuantity":"0",
  "fillTotalAmount":"0",
  "cTime":"1622697148"
}]
}

Response Field

Field	Description
accountId	account id
symbol	Currency pair name
orderId	Order id
clientOrderId	Custom id
price	price
quantity	Order quantity
orderType	Order type
side	Order direction
status	status
fillPrice	Transaction price
fillQuantity	Transaction quantity
fillTotalAmount	Total transcation volume
cTime	Created time

Get Pending Orders

Rate limit rule: 10 request/1s

HTTP Request Get unfilled and partially filled uncancelled orders

• POST /api/spot/v1/trade/open-orders

Request Parameter

Parameters	Type	Required	Description
symbol	String	Yes	Symbol：/products

Response:

{
  "code":"00000",
  "message":"success",
"data":[{
  "accountId":"10012",
  "symbol":"btcusdt_spbl",
  "orderId":"2222222",
  "clientOrderId":"xxxxxxx",
  "price":"34829.12",
  "quantity":"1",  
  "orderType":"limit",
  "side":"buy",
  "status":"new",
  "fillPrice":"0",
  "fillQuantity":"0",
  "fillTotalAmount":"0",
  "cTime":"1622697148"
}]
}

Response Field

Field	Description
accountId	Account ID
symbol	Currency pair
orderId	order id
clientOrderId	Custom id
price	Order price
quantity	Order quantity
orderType	Order type
side	Order direction
status	status
fillPrice	Transaction price
fillQuantity	Transaction quantity
fillTotalAmount	Total transcation volume
cTime	Created time

Get Traded Order Record

Rate limit rule: 20 request/1s

HTTP Request Get all filled and cancelled orders

• POST /api/spot/v1/trade/history

Request Parameter

Response:

{
  "code":"00000",
  "message":"success",
"data":[{
  "accountId":"10012",
  "symbol":"btcusdt_spbl",
  "orderId":"2222222",
  "clientOrderId":"xxxxxxx",
  "price":"34982.12",
  "quantity":"1",  
  "orderType":"limit",
  "side":"buy",
  "status":"new",
  "fillPrice":"34982.12",
  "fillQuantity":"1",
  "fillTotalAmount":"34982.12",
  "cTime":"1622697148"
}]
}

Response Field

Get Transaction Details

Rate limit rule: 20 request/1s

HTTP Request get transaction detail history

• POST /api/spot/v1/trade/fills

Request Parameter

Response:

{
  "code":"",
  "message":"",
  "data":[{
  "accountId":"1001",
  "symbol":"btcusdt_spbl",
  "orderId":"100021",
  "fillId":"102211",
  "orderType":"limit",
  "side":"buy",
  "fillPrice":"38293.12",
  "fillQuantity":"1",
  "fillTotalAmount":"38293.12",
  "cTime":"1622697148",
  "feeCcy":"btc",
  "fees":"0.0001"
}]
}

Response Field