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
}
}