Place Order
Place order
(Authentication type:SIGNED, See Interface Permission)
Request Format
POST https://api-cloud.bitmart.com/spot/v1/submit_order
Request Limit
Request Parameter
Field | Type | Required? | Description |
---|---|---|---|
symbol | string | Yes | Trading pair (e.g. BTC_USDT) |
side | string | Yes | Side |
buy =Buy order |
|||
sell =Sell order |
|||
type | string | Yes | Order type |
Yes | limit =Limit order |
||
Yes | market =Market order |
Special Parameters for Limit Orders (type
=limit)
Field | Type | Required? | Description |
---|---|---|---|
size | string | Yes | Order size |
price | string | Yes | Price |
Special Parameters for Market Orders (type
=market)
Field | Type | Required? | Description |
---|---|---|---|
size | string | Yes | Quantity sold, required when selling at market price size |
notional | string | Yes | Quantity bought, required when buying at market price notional |
Request example
https://api-cloud.bitmart.com/spot/v1/submit_order
{
"symbol":"BTC_USDT",
"side":"buy",
"type":"limit",
"size":"10",
"price":"7000"
}
Response Data
Field | Type | Description |
---|---|---|
order_id | long | Order ID |
Instruction
The request is successful only when order_id is returned.
Example of returned data format
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"order_id":1223181
}
}