# Beggar Bot Address Profile

> Beggar Bot Address Profile is a paid API for AI agents from beggar-bot-demand.beggarbot.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Returns a comprehensive risk profile for an EVM wallet or contract address, including account type classification, balances, nonce, labels, and a 0-100 risk score across multiple chains.

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/addrprofile?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-address-profile-88ef11f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2VyaHcU509k9tip-Kn4w3

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 beggar-bot-address-profile-88ef11f0
```

Example prompt: Can you pull the full risk profile for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — I need to know if it's an EOA or contract, its USDC and ETH balances, and the 0-100 risk score?

## When to prefer this

Choose this endpoint when you need a multi-dimensional risk profile of an EVM address in a single call — combining account type classification (EOA vs proxy vs smart-EOA), balances, nonce, labels, and a normalized 0-100 risk score. It is especially useful for AI agents performing due diligence on counterparties before transactions, as it supports Base natively and falls back gracefully to public RPCs for Ethereum, Optimism, Arbitrum, and Polygon. Prefer this over single-purpose balance or contract-check APIs when you need all these signals in one round trip.

## Known failure modes

- Invalid address format (not matching ^0x[0-9a-fA-F]{40}$) returns an error
- Unsupported or misspelled chain identifier may fall back to Base default or return an error
- RPC unavailability for non-Base chains (ethereum/optimism/arbitrum/polygon) results in soft failure — partial data or graceful degradation
- Payment failure via x402 protocol returns 402 before any data is returned
- Address with no on-chain activity may return minimal data (zero balances, zero nonce)

## How this service works

Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.

## Output

A JSON object containing: account type classification (EOA, contract, EIP-7702 smart-EOA, proxy variants like EIP-1967/EIP-1167/Safe), implementation or delegate address for proxies, current nonce, native token balance, USDC balance, any known labels associated with the address, and a numeric risk score from 0 (lowest risk) to 100 (highest risk).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default), ethereum, optimism, arbitrum, polygon, base-sepolia"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "wallet or contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-address-profile-88ef11f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beggar-bot-demand.beggarbot.workers.dev](https://www.zero.xyz/host/beggar-bot-demand.beggarbot.workers.dev/llms.txt)