Skip to content

Place Order

Endpoint: /v1/spot/order/create

Request Method

POST (form)

Example

Bash
curl -d /v1/spot/order/create

Request Parameters

Parameter Required Type Example Description
symbol Yes string BTC-USDT Trading pair
type Yes string buy-limit Order type: buy-market (market buy), sell-market (market sell), buy-limit (limit buy), sell-limit (limit sell)
amount Yes float 1.343432 For limit orders, this is the order quantity. For market buy orders, this represents the amount to spend (quote currency, e.g. USDT). For market sell orders, this represents the quantity to sell (base currency, e.g. BTC)
price No float 32.3232145 Order price. Not required for market orders

Response Parameters

Parameter Required Type Example Description
errno Yes int 0 Status code
errmsg Yes string success Status message
result Yes object See example Result data

Result Fields

Parameter Required Type Example Description
order_sn Yes string BL786401542840282676 Order serial number
order_id Yes integer 1231 Order ID

Response Example

JSON
{
    "errno": 0,
    "errmsg": "success",
    "result": {
        "order_sn": "BL786401542840282676"
    }
}