Place Spot Order (Market Sell)

POST

https://api.minglobal.io/v1/orders

The same endpoint as above, shown as a MARKET order so the difference is obvious.

Note what is missing: there is no price field. A MARKET order says "fill me now at the best available price", so a price makes no sense. Sending one is rejected outright, not ignored.

A MARKET SELL reserves the base coin, so this example needs 0.001 BTC available in your spot wallet. A MARKET BUY reserves the quote coin plus a slippage buffer, because the final cost is not known in advance.

Check GET /v1/market/depth first. A MARKET order pays the spread, and on a thin book that can be far more than the last traded price suggests.

In the response, price comes back as null and timeInForce comes back as null. Read avgPrice once the order fills to see what you actually got.

Request

Header Params

Body Params application/json

Example

{
  "symbol": "BTC-USDT",
  "side": "SELL",
  "type": "MARKET",
  "quantity": "0.001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.minglobal.io/v1/orders' \
--header 'X-MG-API-KEY: {{api_key}}' \
--header 'X-MG-TIMESTAMP: <set automatically at send time>' \
--header 'X-MG-RECV-WINDOW: {{recv_window}}' \
--header 'X-MG-SIGNATURE: <set automatically at send time>' \
--header 'Origin: {{origin}}' \
--header 'Idempotency-Key: <set automatically at send time>' \
--header 'Content-Type: application/json' \
--data '{
  "symbol": "BTC-USDT",
  "side": "SELL",
  "type": "MARKET",
  "quantity": "0.001"
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
  "id": "clw8n2k4x0004abcdefghij",
  "userId": "clw8n1a2b0000abcdefghij",
  "clientOrderId": "prod_8n1a2b0000ab_9f3c2a",
  "venueOrderId": "1234567890",
  "symbol": "BTC-USDT",
  "marketType": "SPOT",
  "side": "SELL",
  "orderType": "MARKET",
  "timeInForce": null,
  "price": null,
  "quantity": "0.001",
  "filledQty": "0.001",
  "avgPrice": "60011.80",
  "reservedAmount": "0.001",
  "reservedAsset": "BTC",
  "reservedConsumed": "0.001",
  "status": "FILLED",
  "reduceOnly": false,
  "submittedAt": "2026-08-18T09:20:43.100Z",
  "terminalAt": "2026-08-18T09:21:02.000Z",
  "createdAt": "2026-08-18T09:20:43.000Z",
  "updatedAt": "2026-08-18T09:20:43.100Z"
}

Modified at 2026-09-02 09:50:41

Place Spot Order (Limit Buy)

List Your Spot Orders