> Guveno API reference v1.10.0, last updated October 17, 2026. The whole reference is at https://www.guveno.com/llms-full.txt.

## Balances

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

### Per address

**GET** `/wallets/:id/balances`

### Wallet totals

**GET** `/wallets/:id/balances/total`

**GET** `/wallets/:id/stats`

### Company summary

**GET** `/company/balances/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

**GET** `/prices`

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.

Source: https://www.guveno.com/docs/balances/