API Reference›Spot Trading›Place an Order

Place an Order

Submit a spot order to the market.

POST/api/v1/orderWeight: 1TRADE

Place a spot order. A MARKET order fills immediately at the best available price; a LIMIT order rests on the book until it fills at your price or better.

Parameter	Type	Required	Description
symbol	STRING	Yes	The trading pair, e.g. BTCUSDT
side	ENUM	Yes	BUY or SELL
type	ENUM	Yes	LIMIT or MARKET
quantity	DECIMAL	Yes*	Amount of base asset. Required for LIMIT and for MARKET SELL
quoteOrderQty	DECIMAL	Yes*	For a MARKET BUY, spend this much quote asset instead of quantity
price	DECIMAL	Yes*	Required for LIMIT orders
timeInForce	ENUM	Yes*	For LIMIT: GTC, IOC or FOK. Required for LIMIT
clientOrderId	STRING	No	Your own unique id for the order; echoed back and used to query it
timestamp	LONG	Yes	Request time in ms

timeInForce controls a LIMIT order's lifetime: GTC (good til cancelled) rests until filled or cancelled, IOC (immediate or cancel) fills what it can now and cancels the rest, FOK (fill or kill) fills fully at once or not at all.

bash

# LIMIT buy 0.01 BTC at 64000 USDT
curl -X POST -H "X-SDX-APIKEY: $API_KEY" "https://api.spacedex.com/api/v1/order" \
  -d "symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=0.01&price=64000&timeInForce=GTC&timestamp=$TS&signature=$SIG"

json

{
  "orderId": 288274,
  "clientOrderId": "my-order-1",
  "symbol": "BTCUSDT",
  "side": "BUY",
  "type": "LIMIT",
  "price": "64000.00",
  "origQty": "0.01000000",
  "executedQty": "0.00000000",
  "status": "NEW",
  "transactTime": 1717430400123
}

NoteAlways set a clientOrderId. If a network error hides the response, you can query the order by that id to learn whether it was accepted, instead of risking a duplicate.

POST/api/v1/order/testWeight: 1TRADE

Validate an order without sending it to the matching engine. Same parameters as above; a successful test returns an empty object.

PreviousCandlesticks NextCancel & Query Orders