Place Order

Place a new spot trading order with support for various order types including market and limit order.

HTTP Request

POST /api/v1/spot/trade/place-order

Request Parameters

Parameter	Type	Required	Description
base	string	Yes	Base currency (e.g., "BTC")
quote	string	Yes	Quote currency (e.g., "USDT")
orderType	string	Yes	Order type: "MARKET", "LIMIT"
tradeType	string	Yes	Trade type: "BUY" or "SELL"
amount	string	Yes	Order amount in base currency
price	string	No	Order price (required when orderType is "LIMIT")

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/spot/trade/place-order" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "base": "BTC",
    "quote": "USDT",
    "orderType": "LIMIT",
    "tradeType": "BUY",
    "price": "90000.00",
    "amount": "0.001"
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Order response data
> orderId	string	Created order ID

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "orderId": "123456789"
  }
}

Error Codes

Code	Message
40001	Parameter cannot be empty
40001	Price is required for limit orders
40002	Unauthorized
40010	System maintenance
40034	Currency pair does not exist
43008	Market price not available
43008	Insufficient balance
43024	Order price error
43025	Order quantity error
50000	Fee configuration not found
50000	System error