GET/v1/balances/:asset

Retrieve a balance

Returns the current Balance object for a single asset. The asset path parameter is the asset code (USDC, BTC, ...).

Parameters

stringRequired

Asset code in the path. Case-insensitive.

Returns

The Balance object, or 404 not_found if the account has never held that asset.

Errors

Status	Code	Description
404	`not_found`	The account has no record of this asset.
401	`authentication_error`	Missing or invalid API key.

Retrieve a balance

curl https://api.aeses.io/v1/balances/USDC \
-H "x-api-key: sk_live_..."

Response

{
"object": "balance",
"asset": "USDC",
"available": "1250.75",
"pending": "99.50",
"locked": "150.00",
"total": "1500.25",
"updated_at": 1731600125
}