{"uid":"cap_2VyaHcU509k9tip-Kn4w3","slug":"beggar-bot-address-profile-88ef11f0","name":"Beggar Bot Address Profile","description":"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.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/addrprofile?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AAJyOT3n_RkMscnYOLSny","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Screening a payment recipient before sending funds","prompt":"Before I send funds to 0xAbCd1234...5678 on Base, can you check if it's a real EOA or a contract, what its risk score is, and whether it has any known labels flagging it as suspicious?"},{"title":"Auditing a counterparty contract on Arbitrum","prompt":"I need to know if 0x1111111254EEB25477B68fb85Ed929f73A960582 on Arbitrum is a proxy contract — if so, what's the implementation address, and what's the overall risk band?"},{"title":"Validating a new DeFi user wallet on Polygon","prompt":"Can you check the address 0xE592427A0AEce92De3Edee1F18E0157C05861564 on Polygon — is it a fresh EOA or an active account, what's its nonce, and is the risk score low enough to trust it?"}],"resultDescription":"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).","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:21.289Z","isFirstParty":false,"canonicalSlug":"beggar-bot-address-profile-88ef11f0"}