Get Futures Margin Balance

GET

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

How much margin you have available in the futures wallet. This wallet is separate from spot, and futures orders can only spend from it.

Permission: READ_BALANCE

The query schema is strict, and one of the two parameters is required

Send asset, or send symbol, or send both.

If you send both, it is accepted and asset wins. So ?asset=BTC&symbol=ETH-USDT returns the BTC balance.

If you send neither, you get 400 VALIDATION_ERROR with details: [{ "path": "asset", "message": "either asset or symbol is required" }].

Returns exactly three keys: asset, available, locked.

A coin you have never held returns "0" and "0" with 200, not 404.

Request

Query 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/balance?asset={{asset_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

{
  "asset": "USDT",
  "available": "1234.5",
  "locked": "0"
}

🟠400

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

12. Futures Trading API

Open Futures Position (Limit Long)

Get Futures Margin Balance

The query schema is strict, and one of the two parameters is required#

Request

Request Code Samples

Responses

The query schema is strict, and one of the two parameters is required