---
title: "Get balances"
method: GET
path: "/evm/rh/balances"
tags: ["Robinhood Chain"]
---

# Get balances

`GET /evm/rh/balances`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/evm/rh/balances`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/evm/rh/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an owner's ETH and WETH balances on Robinhood Chain — plus an optional token balance — in one round-trip.

## Query parameters

- `owner` string, required
- `tokenAddress` string

## Response `200`

Successfully retrieved balances

- object
  - `success` boolean, required
  - `response` object
    - `ethWei` string, required: Native ETH balance of the owner (wei), as string to support bigint.
    - `wethWei` string, required: WETH balance of the owner (wei), as string to support bigint.
    - `tokenWei` string, nullable, required: Token balance of the owner in token base units, as string to support bigint. Null when no `tokenAddress` was requested.

## Other responses

- `400`: Bad request - Invalid owner or token address
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)