Get One Futures Order

GET

https://api.minglobal.io/v1/futures/orders/{orderId}

Read a single futures order.

Permission: READ_ORDERS

It does not include fills, unlike the two list endpoints. If you need the executions, the fees or the realized profit, use GET /v1/futures/orders/history instead.

Rejected orders do carry rejectReason and venueCode here.

Errors: 404 NOT_FOUND with the message "Order not found", for an unknown id or one belonging to another user. The API never confirms that someone else's id exists.

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api.minglobal.io/v1/futures/orders/{{futures_order_id}}' \
--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}}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "id": "clw8n2k4x0009abcdefghij",
  "userId": "clw8n1a2b0000abcdefghij",
  "clientOrderId": "prod_8n1a2b0000ab_4c7e91a2",
  "venueOrderId": "9876543210",
  "symbol": "BTC-USDT",
  "positionSide": "LONG",
  "side": "BUY",
  "orderType": "LIMIT",
  "timeInForce": "GTC",
  "price": "60000",
  "quantity": "0.01",
  "filledQty": "0.01",
  "avgPrice": "59998.5",
  "leverage": 10,
  "marginMode": "ISOLATED",
  "reservedAmount": "63",
  "reservedAsset": "USDT",
  "status": "FILLED",
  "reduceOnly": false,
  "submittedAt": "2026-08-18T09:20:43.100Z",
  "terminalAt": "2026-08-18T09:25:00.000Z",
  "createdAt": "2026-08-18T09:20:43.000Z",
  "updatedAt": "2026-08-18T09:20:43.100Z"
}

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

Get Futures Order History

Cancel Futures Order