{
"client_oid":"ww#123456", //Client ID
"order_id":"513466539039522813" //Order ID
}
Response Filed
Place Multiple Orders
Rate Limit：10 requests per second
HTTP Requests Place multiple orders
POST /api/swap/v3/order/batchOrders
Request Parameter
Response:
{
"result":true,
"order_info":[
{
"result":true, //Result of an Order
"client_oid":"dxdanzi", //Client ID
"order_id":"513468410013679613" //Order ID
},
{
"result":true,
"client_oid":"dxdanzi",
"order_id":"513468410001096713"
}
]
}
Response Filed
Cancel Order
Rate Limit：10 requests per seconds
HTTP Requests request to cancel order
POST /api/swap/v3/order/cancel_order
Request Parameter
Response:
{
"symbol":"cmt_btcusdt", //Contract name
"order_id":"513468410013679613", //Order ID
"client_oid":"bitget#123456", //Client ID
"result":true //Cancellation status
}
Response Filed
Cancel Multiple Orders
Rate Limit：10 requests per seconds
HTTP Requests Cancel multiple orders
POST /api/swap/v3/order/cancel_batch_orders
Request Parameter
Response:
{
"symbol":"cmt_btcusdt", //Contract name
"result":true, //processing result
"order_ids":[
"258414711", //Successful id
"478585558"
],
"fail_infos":[
{
"order_id":"258414711", //Failed id
"err_code":"401", //Error code
"err_msg":"" //Error message
}
]
}
Response Filed
Get The Order Details By Order Id
Rate Limit：10 requests per second
HTTP Requests get the order details by order id
GET /api/swap/v3/order/detail
Request Parameter
Response:
{
"symbol":"cmt_btcusdt", //Contract name
"size":"12", //The amount in this order
"timestamp":"15582271175271", //Obsolete field
"client_oid":"cmdtde", //Client ID
"createTime":"1698475585258", //Creation time
"filled_qty":"0", //The amount which has been filled
"fee":"0", //Transaction fee
"order_id":"513468410013679613", //Order ID
"price":"12", //The limit price of limit order
"price_avg":"0", //Average filled price
"status":"-1", //Order status
"type":"1", //Commission type
"order_type":"0", //Order type
"totalProfits":"253" //Total profit and loss
}
[
{
"symbol":"cmt_btcusdt", //Contract name
"size":"12", //The amount in this order
"client_oid":"cmdtde", //Client ID
"createTime":"1698475585258", //Creation time
"filled_qty":"0", //The amount which has been filled
"fee":"0", //Transaction fee
"order_id":"513468410013679613", //Order ID
"price":"12", //The limit price of limit order
"price_avg":"0", //Average filled price
"status":"-1", //Order status
"type":"1", //Commission type
"order_type":"0", //Order type
"totalProfits":"253" //Total profit and loss
}
]
Response Filed
Get Transaction Details
Rate Limit：10 requests per second
HTTP Requests get transaction details
GET /api/swap/v3/order/fills
Request Parameter
Response:
[
{
"symbol":"cmt_btcusdt", //Contract name
"trade_id":"6667390", //trade Id
"order_id":"525946425993854915", //order id
"price":"9839.00", //deal price
"order_qty":"3466", //Quantity
"fee":"-0.0000528407360000", //transaction fee
"timestamp":"1561121514442", //Creation time
"exec_type":"M", //Liquidity direction Taker or maker (T or M)
"side":"3", //Commission type Mark obsolete
"delegateType":"3" //Commission type
}
]
Response Filed
New Trigger Order
Rate Limit：10 requests per second
HTTP Requests New trigger order
POST /api/swap/v3/order/plan_order
Request Parameter
Response:
{
"client_oid":"bitget#123456", //Client ID
"order_id":"589579827556646928" //trigger Order ID
}
Response Filed
Cancel Trigger Order
Rate Limit：10 requests per second
HTTP Requests Cancel trigger order
POST /api/swap/v3/order/cancel_plan
Request Parameter
Response:
{
"order_id":"5895798275566469458", //Order ID
"client_oid":"bitget#123456", //Client ID
"result":false, //Status of cancellation
"err_code":"403", //Code of cancellation
"err_msg":"order not exist" //Reason of cancellation
}
Response Filed
Get Current Trigger Orders
Rate Limit：10 requests per second
HTTP Requests Get current trigger orders
GET /api/swap/v3/order/currentPlan
Request Parameter
Response:
{
"list":[
{
"symbol":"cmt_btcusdt", //Contract name
"execute_count":"0", //amount of Stop
"delegate_count":"1222222", //amount of Limit
"create_time":1576294708136, //Created time
"update_time":1576294708136, //Updated time
"direction":1, //Direction
"direction_desc":"开多", //Description of direction
"trigger_price":"22222210.0", //Stop price
"execute_price":"7490.0", //limit price (execute price)
"order_id":"589588227514433528", //Order ID
"order_type":0, //Order Type
"status":1, //status
"status_desc":"status", //Description of status
"create_trade_price":"7490" //Executed price of stop limit
}
],
"nextPage":false //Next page
}
Response Filed
Get The History Of Trigger Order
Rate Limit：10 requests per second
HTTP Requests Get The History Of Trigger Order
GET /api/swap/v3/order/historyPlan
Request Parameter
Response:
{
"list":[
{
"symbol":"cmt_btcusdt", //Contract name
"execute_count":"0", //amount of Stop
"delegate_count":"1222222", //amount of Limit
"create_time":1576294708136, //Created time
"update_time":1576294708136, //Updated time
"direction":1, //Direction
"direction_desc":"开多", //Description of direction
"trigger_price":"22222210.0", //Stop price
"execute_price":"7490.0", //limit price (execute price)
"order_id":"589588227514433528", //Order ID
"order_type":0, //Order Type
"status":1, //status
"status_desc":"status", //Description of status
"create_trade_price":"7490" //Executed price of stop limit
}
],
"nextPage":false //Next page
}