Get Account Balance

Developing

GET

/api/v1/accounts/{accountId}/balances

This endpoint retrieves the current balance(s) for the authenticated merchant account. You may query a specific currency or fetch all available balances at once.

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.geoaccount.com/api/v1/accounts//balances?currency=CNY' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx' \
--header 'GS-API-Key: gs_live_abc123def456789'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "accountId": "acc_123",
    "asOf": "2026-03-27T11:40:00Z",
    "balances": [
        {
            "asset": {
                "code": "USD",
                "type": "fiat"
            },
            "balance": {
                "total": 1000.00,
                "available": 900.00,
                "locked": 100.00,
                "pending": 0.00
            }
        },
        {
            "asset": {
                "code": "USDT",
                "type": "crypto",
                "network": "TRON"
            },
            "balance": {
                "total": 500.00,
                "available": 500.00,
                "locked": 0.00,
                "pending": 0.00
            }
        }
    ]
}

Modified at 2026-03-27 07:51:22

Get Account

Transaction Declaration Filing