# Zapper DeFi App Balances

> Zapper DeFi App Balances is a paid API for AI agents from public.zapper.xyz, paid per call via x402, $0.001125/call, status down (last checked 2026-09-15, last successful call 2026-06-05).

Fetches DeFi protocol/app balances (e.g. lending, staking, liquidity positions) across multiple wallet addresses using Zapper's x402 API

## Facts

- Endpoint: POST https://public.zapper.xyz/x402/defi-balances
- Price: $0.001125/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Last successful call: 2026-06-05
- Success rate: 100% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-zapper-xyz-94b80105
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p0sV0bp_3yu65nz-3B28f

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 public-zapper-xyz-94b80105 -d '<json body>'
```

Example prompt: Can you pull up the DeFi app balances for my wallets 0xABC...123 and 0xDEF...456 on Zapper — show me the first 10 app positions so I can see what protocols I'm in?

## When to prefer this

Use this endpoint when you need to retrieve DeFi protocol-specific positions (lending, staking, liquidity) for one or more wallets, as opposed to raw token balances or NFT holdings. Prefer this over the token balances endpoint when the user cares about app-level positions like Aave deposits, Uniswap LP shares, or Compound borrows.

## Known failure modes

- Invalid or malformed wallet addresses return an error
- Missing required 'addresses' or 'first' fields causes a validation error
- Empty addresses array returns no results
- Rate limiting or payment failure may block the request
- Addresses with no DeFi positions return empty records

## How this service works

Get DeFi balances (Liquidity Pools, Yield Farming, Lending, etc.) for a single address, or a list of addresses.

## Output

Returns a paginated list of DeFi application balance records for the specified wallet addresses, including positions in lending protocols, liquidity pools, staking contracts, and other on-chain apps tracked by Zapper.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "first": {
   "type": "integer",
   "default": 10,
   "description": "Number of DeFi positions to return (max 50)"
  },
  "chainIds": {
   "type": "array",
   "items": {
    "type": "integer"
   },
   "description": "Optional list of Chain IDs to filter by"
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string",
    "description": "A 0x wallet address"
   },
   "description": "Array of 0x wallet addresses to aggregate"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-zapper-xyz-94b80105/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from public.zapper.xyz](https://www.zero.xyz/host/public.zapper.xyz/llms.txt)