---
title: "Multi-chain wallet balance context for an agent address"
method: GET
path: "/v1/agent/balances"
tags: ["Wallet"]
---

# Multi-chain wallet balance context for an agent address

`GET /v1/agent/balances`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/balances`
- Auth: none declared

Read-only multi-chain token balance context used to ground
recommendations in the caller's actual wallet state. The queried
address must match the authenticated tenant wallet when a bound
API key is presented. Balances are directional reads, not custody.

## Query parameters

- `address` string, required
- `chains` string
- `summary` 'true' | 'false'

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Wallet balance context (labeled estimates; no custody)

## Other responses

- `402`: Free-tier limit exceeded — x402 payment required
- `403`: Queried address does not match the bound tenant wallet.
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)