# LensCrypt Wallet Balance Lookup

> LensCrypt Wallet Balance Lookup is a paid API for AI agents from tolens.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-08).

Retrieves the token balances for a given blockchain wallet address

## Facts

- Endpoint: GET https://tolens.vercel.app/api/balance/%7Baddress%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lenscrypt-wallet-balance-lookup-77c82e0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KsSbshM73V6N2rElYaGVP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability lenscrypt-wallet-balance-lookup-77c82e0b
```

Example prompt: What tokens and balances does the wallet 0x1234...abcd currently hold? Use LensCrypt to look it up.

## When to prefer this

Use this endpoint when you need a quick, pay-per-call balance lookup for a specific wallet address without setting up a full node or subscribing to an indexer. Ideal for agents that need on-demand wallet data as part of a broader crypto analytics workflow, especially when combined with other LensCrypt endpoints like token safety or whale tracking.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Address with no on-chain history may return empty balances
- Network timeout or service unavailability returns a non-200 status
- Unsupported chain addresses may return no data
- Payment failure via x402 protocol results in 402 status and no data returned

## How this service works

81 paid REST endpoints covering wallet analytics, DeFi yields, token safety, smart money tracking, whale alerts, sniper detection, GMX perps, Solana tools, protocol stats, gas tracking, DEX quotes, NFT analytics, social signals, and 8 AI-powered endpoints (MiMo V2.5). Pay USDC via x402 protocol on Base.

## Output

Returns a JSON object containing the token balances and holdings associated with the queried wallet address, including asset names and amounts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lenscrypt-wallet-balance-lookup-77c82e0b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tolens.vercel.app](https://www.zero.xyz/host/tolens.vercel.app/llms.txt)