Close Futures Position (Reduce Only)

POST

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

How you close a position: send the opposite side on the same positionSide, with reduceOnly: true.

This example closes the LONG opened above. The position side stays LONG because that is the position being closed. The side flips to SELL because selling is what closes a long.

Closing a position is not the same as cancelling an order.
Cancel (DELETE /v1/futures/orders/{id}) removes an order that has not filled yet.
Close (this request) opens an opposing order that flattens a position you already hold.
Cancelling a filled order does nothing. You still hold the position.

reduceOnly: true is the safety catch. It guarantees the order can only shrink an existing position, never open a new one or flip you into the opposite direction if you get the quantity wrong. Always use it when closing.

A reduceOnly order fully covered by an existing position can reserve "0" margin, which is correct and not a bug.

Permission: FUTURES_TRADE

Request

Header Params

Body Params application/json

Example

{
  "symbol": "BTC-USDT",
  "positionSide": "LONG",
  "side": "SELL",
  "orderType": "MARKET",
  "quantity": "0.01",
  "leverage": 10,
  "marginMode": "ISOLATED",
  "reduceOnly": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.minglobal.io/v1/futures/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",
  "positionSide": "LONG",
  "side": "SELL",
  "orderType": "MARKET",
  "quantity": "0.01",
  "leverage": 10,
  "marginMode": "ISOLATED",
  "reduceOnly": true
}'

Responses

🟢201

application/json

Bodyapplication/json

Example

{
  "id": "clw8n2k4x0011abcdefghij",
  "userId": "clw8n1a2b0000abcdefghij",
  "clientOrderId": "prod_8n1a2b0000ab_4c7e91a2",
  "venueOrderId": "9876543210",
  "symbol": "BTC-USDT",
  "positionSide": "LONG",
  "side": "SELL",
  "orderType": "MARKET",
  "timeInForce": null,
  "price": null,
  "quantity": "0.01",
  "filledQty": "0.01",
  "avgPrice": "60110.20",
  "leverage": 10,
  "marginMode": "ISOLATED",
  "reservedAmount": "0",
  "reservedAsset": "USDT",
  "status": "FILLED",
  "reduceOnly": true,
  "submittedAt": "2026-08-18T09:20:43.100Z",
  "terminalAt": "2026-08-18T10:02:00.000Z",
  "createdAt": "2026-08-18T09:20:43.000Z",
  "updatedAt": "2026-08-18T09:20:43.100Z"
}

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

Open Futures Position (Limit Long)

List Open Futures Orders