Balances

Read balances per address, per wallet, or across the whole company.

Per address

Wallet totals

Company summary

Query params: chain, network.

curl https://api.guveno.com/v1/company/balances/summary \
  -H "Authorization: Bearer gv_live_your_key_here"

{
  "items": [
    { "asset": "ETH", "chain": "ethereum", "network": "mainnet", "amount": "18.42" },
    { "asset": "USDT", "chain": "ethereum", "network": "mainnet", "amount": "120500.00" }
  ]
}

Estimated value

Rough USD price per whole unit for the supported mainnet assets, sourced from an external market feed and cached server-side for a few minutes. Multiply a balance by its symbol's price to get an estimated value. A symbol is omitted when the source didn't return it, and updatedAt is null when prices are momentarily unavailable.

curl https://api.guveno.com/v1/prices \
  -H "Authorization: Bearer gv_live_your_key_here"

{
  "prices": { "BTC": 64210.5, "ETH": 3380.2, "XRP": 0.51, "DOT": 6.9 },
  "updatedAt": "2026-06-25T12:00:00.000Z"
}

These are estimates, not settlement rates. Testnet assets (Sepolia, Bitcoin/XRP testnet, Paseo) have no monetary value and are not priced, so treat them as 0.