# aiworker-data Wallet Check

> aiworker-data Wallet Check is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns on-chain facts about a Base network wallet address: ETH balance, token holdings, transaction counts, and activity timeline

## Facts

- Endpoint: POST https://aiworker.duckdns.org/v1/check/wallet
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-data-wallet-check-0c252e1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4XOdJgTRTogRsPSoS2HWQ

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 aiworker-data-wallet-check-0c252e1a -d '<json body>'
```

Example prompt: Can you pull up the on-chain profile for Base wallet 0x46f64bec31eaf281176f9bb5899107a80e932b45 — I want to see its ETH balance, token holdings, transaction count, and when it was last active?

## When to prefer this

Use this endpoint when you need deterministic, sourced on-chain facts about a specific Base network address — balances, activity history, and token holdings — rather than price feeds or identity/label lookups. It is paid per-call via USDC/x402, making it suitable for agent workflows that need verifiable blockchain data without running a full node or managing RPC infrastructure.

## Known failure modes

- Invalid address format (not 0x + 40 hex chars) returns a validation error
- Address not found on Base returns empty or null holdings
- Blockscout API downtime may cause upstream fetch failure
- Smart contract addresses return kind='contract' but may have limited EOA-specific fields
- Very new addresses with no transactions may return minimal data

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

A JSON object containing: wallet kind (EOA or contract), ETH balance, list of token holdings with symbol/balance/decimals, total transaction count, token transfer count, first-seen timestamp, last-activity timestamp, any flags, a human-readable summary sentence, and attribution to Blockscout/Base RPC data sources.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "The 0x-prefixed 40-hex Base address to check"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "eoa",
  "flags": [],
  "address": "0x46f64bec31eaf281176f9bb5899107a80e932b45",
  "sources": [
   {
    "ok": true,
    "url": "https://base.blockscout.com/api/v2/addresses/0x46f64bec31eaf281176f9bb5899107a80e932b45",
    "name": "blockscout_address"
   }
  ],
  "summary": "EOA on Base, first seen 2024-02-24, last active 2026-09-10, 412 transactions, 0.184213 ETH, 1 token holding.",
  "holdings": [
   {
    "symbol": "BRETT",
    "address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
    "balance": "15200.5",
    "decimals": 18,
    "balance_usd": null
   }
  ],
  "tx_count": 412,
  "disclaimer": "on-chain facts only; no identity, no labels, no advice",
  "first_seen": "2024-02-24T06:09:27.000Z",
  "attribution": "Data: Blockscout (Base), Base RPC",
  "eth_balance": "0.184213",
  "generated_at": "2026-09-11T00:00:00.000Z",
  "last_activity": "2026-09-10T18:41:03.000Z",
  "token_transfer_count": 1287
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-data-wallet-check-0c252e1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)