---
title: "Get an ERC-8004 agent's USDC balance on Base"
method: GET
path: "/v1/wallet/balance"
---

# Get an ERC-8004 agent's USDC balance on Base

`GET /v1/wallet/balance`

## Request

- Base URL: `https://api.limitguard.ai`
- URL: `https://api.limitguard.ai/v1/wallet/balance`
- Auth: one of:
  - API key in header `X-API-Key`
  - none

ERC-8004 agent wallet balance check. Returns the on-chain USDC balance (Base mainnet) for a registered ERC-8004 agent wallet.

## Query parameters

- `agent_id` string, required

## Response `200`

Success

## Other responses

- `402`: Payment required. The x402 v2 challenge is in the base64 PAYMENT-REQUIRED header and the JSON body; pay and retry with PAYMENT-SIGNATURE, or send X-API-Key with prepaid balance.

---

[API](https://skmtc.dev/limitguard/apis/limitguard-ai.md) · [All operations](https://skmtc.dev/limitguard/apis/limitguard-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/limitguard/apis/limitguard-ai/revisions/8f9718bce4a1?raw)