Get Account Balance

API Description

Retrieves account balance information for a specific address on a given chain. This endpoint provides detailed balance data including available balance, reserved balance, pending balance, and portfolio information for all tokens in the account.

HTTP Request

GET /v4/public/mm/account/wallet-balance

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
address	string	Yes	Trader wallet address (EVM address format)

Response Parameters

Parameter	Type	Description
address	string	The queried wallet address
portfolios	array	Array of portfolio information for each token
-> quote	string	Token contract address
-> decimals	number	Token decimal places
-> balance	string	Current available balance
-> pendingBalance	object	Pending balance information
-> -> timestamp	number	Pending balance timestamp
-> -> native	boolean	Whether the token is native (ETH, etc.)
-> -> amount	string	Pending amount
-> -> exemption	string	Exemption amount
-> totalInBalance	string	Total amount deposited into the account
-> totalOutBalance	string	Total amount withdrawn from the account
-> reservedBalance	string	Reserved balance (locked for orders/positions)
-> thresholdBalance	string	Minimum balance threshold
-> maxWithdrawable	string	Maximum amount that can be withdrawn
-> symbol	string	Token symbol (e.g., USDC, ETH)
-> imageUrl	string	Token image URL
-> currentPrice	number	Current token price
isBlacklisted	boolean	Whether the address is blacklisted
pendingDuration	string	Pending duration in seconds

Request Example

Python (requests)

Note: This endpoint requires API authentication. See Quick Start Guide for signature generation details.

import hmac
import hashlib
import base64
import json
import requests
from datetime import datetime, timezone
from urllib.parse import urlencode

def generate_mm_signature(secret_key, timestamp, method, request_path, body="", content_type=""):
    """Generate API signature"""
    message = timestamp + method.upper() + request_path
    if body and method.upper() in ["POST", "PUT", "PATCH"]:
        if content_type and "application/json" in content_type.lower():
            data = json.loads(body)
            body = json.dumps(data, sort_keys=True, separators=(',', ':'))
        message += body
    
    mac = hmac.new(
        secret_key.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    )
    return base64.b64encode(mac.digest()).decode('utf-8')

# Generate timestamp
timestamp = datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')

# Build request path with sorted query parameters
params = {
    'chainId': 143,
    'address': '0x8bcef483f1c9226c192430b8f5191ee801601480'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/account/wallet-balance?{query_string}"

# Generate signature
signature = generate_mm_signature(secret_key, timestamp, "GET", request_path)

# Make request
headers = {
    "X-ACCESS-KEY": api_key,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": passphrase,
}

url = f"https://api.monday.trade/v4/public/mm/account/wallet-balance?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": {
        "address": "0x8bcef483f1c9226c192430b8f5191ee801601480",
        "portfolios": [
            {
                "quote": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                "decimals": 6,
                "balance": "5727011",
                "pendingBalance": {
                    "timestamp": 0,
                    "native": false,
                    "amount": "0",
                    "exemption": "0"
                },
                "totalInBalance": "85378660",
                "totalOutBalance": "0",
                "reservedBalance": "5727011",
                "thresholdBalance": "50000000000",
                "maxWithdrawable": "5727011",
                "symbol": "USDC",
                "imageUrl": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",
                "currentPrice": 0.999997
            }
        ],
        "isBlacklisted": false,
        "pendingDuration": "86400"
    },
    "msg": "",
    "code": 0,
    "requestId": "1e65034f-919c-4f83-955f-c94e291a85a4"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "7397e577-65d1-41d8-9ffe-499b2f322ed0"
}

Notes

• This endpoint requires API authentication (see Quick Start Guide)

• Both chainId and address parameters are required

• The address must be a valid EVM address format

• Returns balance information for all tokens in the account on the specified chain

• balance: Current available balance that can be used for trading

• reservedBalance: Balance locked for open orders or positions

• maxWithdrawable: Maximum amount that can be withdrawn (balance - reservedBalance)

• pendingBalance: Balance that is pending (e.g., pending withdrawals)

• isBlacklisted: Indicates if the address is blacklisted

• pendingDuration: Duration in seconds for pending operations

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)