Step 2. Your First Signed Request

GET

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

Your first authenticated call. It reads your balances and changes nothing, so it is safe to run as often as you like.

The collection signs it for you using api_key, api_secret, origin and recv_window. If this succeeds, every other endpoint in this collection will work, because they all share one signing scheme.

If it fails, read the code in the response body and check the table on this folder's overview page. The error names the exact problem.

Permission: READ_BALANCE

Request

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.minglobal.io/v1/wallets/balance' \
--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

{
  "balances": [
    {
      "id": "clw8n2k4x0001abcdefghij",
      "userId": "clw8n1a2b0000abcdefghij",
      "tokenId": 1,
      "walletType": "SPOT",
      "coin": "USDT",
      "name": "Tether",
      "availableBalance": "1500.25",
      "lockedBalance": "200",
      "version": 42,
      "updatedAt": "2026-08-18T09:20:43.000Z"
    }
  ],
  "pending": {}
}

🟠401

🟠403

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

Step 1. Check API Reachability (no key needed)

02. Authentication and Request Signing