# IOTA Wallet Balance and Names

> IOTA Wallet Balance and Names is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.002/call, status healthy (last checked 2026-10-31, last successful call 2026-10-26).

Looks up an IOTA mainnet address or IOTA name (e.g. alice.iota) to return token balances, staking info, USD values, name-to-address resolution, and recent outgoing transactions.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/iota-address?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-31
- Last successful call: 2026-10-26
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iota-wallet-balance-and-names-6ba53b55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E774gQn19Wetq1UmFcR4h

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 iota-wallet-balance-and-names-6ba53b55 -d '<json body>'
```

Example prompt: What's the IOTA balance, staked amount, and USD value for the address 0x3a7b2c1d...f9e8, and does it have an IOTA name associated with it?

## When to prefer this

Use this endpoint when you need comprehensive on-chain data for an IOTA mainnet address or IOTA name in a single call — covering balances, staking, USD valuation, name resolution, and recent transactions. Prefer this over block explorer UIs or raw RPC calls when you need structured, aggregated data ready for agent consumption without parsing raw blockchain responses.

## Known failure modes

- Invalid address format (not 0x + 64 hex) returns an error
- Unknown IOTA name (not registered) returns not found
- Network or RPC node unavailability causes timeout
- Address with no activity returns empty transaction list and zero balances
- Malformed input missing both address and name returns validation error

## How this service works

Everything about an IOTA mainnet address or IOTA name (alice.iota): IOTA balance and every other coin with symbol, staked IOTA per validator with estimated rewards, USD value, the IOTA name pointing to it and its latest outgoing transactions. Resolves names to addresses and back.

## Output

Returns the IOTA balance and all other coin holdings with their symbols, staked IOTA broken down by validator with estimated rewards, USD value of holdings, the IOTA name (if any) pointing to the address, the resolved address (for name inputs), and the most recent outgoing transactions from the address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "IOTA address (0x + 64 hex) or IOTA name like alice.iota"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iota-wallet-balance-and-names-6ba53b55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)