{
"object": "list",
"data": [
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400
}
],
"as_of": 1789084800
}{
"error": {
"code": "internal_error",
"message": "Internal server error."
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "The balance query service is temporarily unavailable. Retry later with a new timestamp, nonce, and signature."
},
"request_id": "example-request-id",
"timestamp": 1789084800
}List global accounts
List all Balance Accounts and their balances for the merchant associated with the current API Key, including system default and merchant-defined accounts. No merchant_id is required. Pagination and business filters are not supported.
The list uses object: list and a data array, without a global_accounts wrapper. The current version does not return an account-level pending_amount.
Authentication follows the common authentication specification. Do not pass merchant_id or X-Merchant-Id; the server only queries data for the merchant associated with the current API Key. No request body is required. Amount examples are fictional and use the smallest ledger unit.
{
"object": "list",
"data": [
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400
}
],
"as_of": 1789084800
}{
"error": {
"code": "internal_error",
"message": "Internal server error."
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "The balance query service is temporarily unavailable. Retry later with a new timestamp, nonce, and signature."
},
"request_id": "example-request-id",
"timestamp": 1789084800
}Authorizations
Bearer API Key, for example Bearer sk_live_xxx.
Unix timestamp in seconds. Must be within 5 minutes of the server time.
Random string for replay protection, 16–64 characters.
HMAC-SHA256 signature computed using the merchant API Secret, encoded as lowercase hex.
Headers
Unix timestamp in seconds. Must be within 5 minutes of the server time.
Random string for replay protection, 16–64 characters. A new UUID is recommended for each request.
16 - 64Compute HMAC-SHA256 over {timestamp}.{nonce}.{requestBody} using the merchant API Secret and encode the result as lowercase hex. For GET requests, requestBody is an empty string.
Response
Query successful.
List object identifier.
list Accounts belonging to the current merchant. Returns an empty array if there are no accounts.
Show child attributes
Show child attributes
Database observation time for this query, in Unix seconds. This is not a data version and does not guarantee that multiple requests share the same snapshot.
Was this page helpful?