1. 12. Futures Trading API
MIN-Global API
  • MinGlobal External API (v1)
    • 01. Overview and Quick Start
      • Step 1. Check API Reachability (no key needed)
      • Step 2. Your First Signed Request
    • 02. Authentication and Request Signing
    • 03. Spot Trading Explained
    • 04. Futures Trading Explained
    • 05. Data Formats and Conventions
    • 06. Errors and Troubleshooting
    • 07. Rate Limits, Permissions and Known Limits
    • 08. Market Data API (public, no key needed)
      • List Spot Trading Pairs
      • Get All Spot Tickers
      • Get Spot Candlesticks (Klines)
      • Get Spot Order Book (Depth)
      • Get Recent Spot Trades
      • List Futures Contracts
      • Get All Futures Tickers
      • Get Futures Candlesticks (Klines)
      • Get Futures Order Book (Depth)
      • Get Recent Futures Trades
    • 09. Wallets and Balances API
      • Get All Balances
      • Get Balances by Coin
    • 10. Assets and Networks API
      • List Supported Coins
      • List Networks for a Coin
    • 11. Spot Trading API
      • Place Spot Order (Limit Buy)
      • Place Spot Order (Market Sell)
      • List Your Spot Orders
      • Get One Spot Order
      • Cancel Spot Order
    • 12. Futures Trading API
      • Get Futures Margin Balance
        GET
      • Open Futures Position (Limit Long)
        POST
      • Close Futures Position (Reduce Only)
        POST
      • List Open Futures Orders
        GET
      • Get Futures Order History
        GET
      • Get One Futures Order
        GET
      • Cancel Futures Order
        DELETE
  1. 12. Futures Trading API

List Open Futures Orders

GET
https://api.minglobal.io/v1/futures/orders
Your futures orders that are not finished yet. The exact complement of the history endpoint: an order is in one list or the other, never both.
Permission: READ_ORDERS

Only limit actually filters#

symbol, orderType, startTime and endTime all validate, return 200, and then have no effect on the result set. A client that sends ?symbol=BTC-USDT receives orders for every symbol, and if it trusts the filter it will act on the wrong ones. Filter in your own code until this is fixed. The four are included above, disabled, so you can see them without being caught out.
The response is a bare JSON array, newest first, with no pagination envelope. limit is the only control, so you cannot read past your most recent 200 rows.
Each element is a full order object plus a fills array. There are no order-level fee, feeAsset or realisedPnl fields, so add up fills[].feeAmount and fills[].realisedPnl yourself.
This list never carries rejectReason or venueCode, because a rejected order is finished by definition and therefore lives in history.

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.minglobal.io/v1/futures/orders?limit=50' \
--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",
    "avgPrice": null,
    "leverage": 10,
    "marginMode": "ISOLATED",
    "reservedAmount": "63",
    "reservedAsset": "USDT",
    "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",
    "fills": []
  }
]
Modified at 2026-09-02 09:50:41
Previous
Close Futures Position (Reduce Only)
Next
Get Futures Order History
Built with