Place Spot Order (Limit Buy)

Places a spot order. Funds are reserved immediately. Submission to the venue happens separately.

Permission: SPOT_TRADE | Success: 201 Created

Request body

The schema is strict. Any key it does not recognize rejects the whole request.

Field	Type	Required	Notes
`symbol`	string	Yes	`BASE-QUOTE`, 2 to 15 alphanumerics each side. Lowercase is accepted and uppercased
`side`	string	Yes	`BUY` or `SELL`
`type`	string	Yes	`MARKET` or `LIMIT`
`quantity`	decimal string	Yes	Greater than 0. Up to 20 integer and 18 fractional digits. No sign, no exponent
`price`	decimal string	Conditional	Required for `LIMIT`. Must be left out for `MARKET`. Sending it is a rejection, not an ignore

There is no clientOrderId input. The server mints one for you.

What gets reserved

A BUY reserves the quote coin (quantity x price, plus a slippage buffer on MARKET). A SELL reserves the base coin. reservedAsset tells you which. Fees are not part of the reserve, so leave headroom. If funds are short, nothing at all is written and you get 409.

Reading the response

201 does not mean the market accepted your order
It means we accepted it and set your money aside. The venue's verdict comes later, and a rejection is not an HTTP error. Branch on the status field in the body, never on the HTTP status code.
PENDING_SUBMIT and SUBMITTED are in flight. FILLED, CANCELED, EXPIRED and REJECTED are final. UNKNOWN means the venue did not answer, your funds are still reserved, and you must poll rather than re-place.

The field you send is type. The field you get back is orderType. They are not the same name. timeInForce comes back as "GTC" on LIMIT and null on MARKET, and price is null on MARKET.

Errors

Status	`code`	Cause
`400`	`VALIDATION_ERROR`	Schema failure, an instrument limit breach, or a missing `Idempotency-Key`
`409`	`INSUFFICIENT_BALANCE`	Not enough spendable balance to reserve. Nothing was written
`409`	`IDEMPOTENCY_IN_PROGRESS`	An earlier request with this key is still running
`429`	`TOO_MANY_OPEN_ORDERS`	200 orders already open on this symbol. Retrying will not help, so cancel one
`429`	`RATE_LIMIT_EXCEEDED`	Per-key rate limit
`403`	`API_PERMISSION_DENIED`	The key lacks `SPOT_TRADE`

Instrument limit failures arrive as 400 VALIDATION_ERROR, and the message usually suggests a corrected value, for example price must be a multiple of tickSize (0.01), try 60000.00.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201

application/json

Bodyapplication/json

Example

{
  "id": "clw8n2k4x0003abcdefghij",
  "userId": "clw8n1a2b0000abcdefghij",
  "clientOrderId": "prod_8n1a2b0000ab_9f3c2a",
  "venueOrderId": "1234567890",
  "symbol": "BTC-USDT",
  "marketType": "SPOT",
  "side": "BUY",
  "orderType": "LIMIT",
  "timeInForce": "GTC",
  "price": "60000",
  "quantity": "0.001",
  "filledQty": "0",
  "avgPrice": null,
  "reservedAmount": "60",
  "reservedAsset": "USDT",
  "reservedConsumed": "0",
  "status": "SUBMITTED",
  "reduceOnly": false,
  "submittedAt": "2026-08-18T09:20:43.100Z",
  "terminalAt": null,
  "createdAt": "2026-08-18T09:20:43.000Z",
  "updatedAt": "2026-08-18T09:20:43.100Z"
}

🟠400

🟠409

Place Spot Order (Limit Buy)

Request body#

What gets reserved#

Reading the response#

201 does not mean the market accepted your order#

Errors#