---
title: "Wallet balances for every curated token on a chain, plus native"
method: GET
path: "/balances"
---

# Wallet balances for every curated token on a chain, plus native

`GET /balances`

## Request

- Base URL: `https://swap.vurto.cc/v1`
- URL: `https://swap.vurto.cc/v1/balances`
- Auth: none required

One multicall per chain, batched in slices so a bad token can't zero out the whole response. Only non-zero balances are included. Rate-limited per IP (40/min).

## Query parameters

- `chainId` integer, required
- `wallet` string, required

## Response `200`

OK

- object
  - `chainId` integer
  - `balances` object: Keyed by lowercase token address, or the literal 'native'. Raw integer strings.
  - `usd` object: Same keys as balances, best-effort — a missing key means price lookup failed, not that the balance is zero.

---

[API](https://skmtc.dev/vurto/apis/vurto-swap-public-api.md) · [All operations](https://skmtc.dev/vurto/apis/vurto-swap-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vurto/apis/vurto-swap-public-api/revisions/423be3a193b5?raw)