{"uid":"cap_sG8mgnxOhlzyI1oA5WNHS","slug":"blockpin-agent-income-rebuild-843072b6","name":"Blockpin Agent Income Rebuild","description":"Agent income rebuild: every payment into an agent wallet in one asset (an ERC-20, or native ETH including escrow withdrawals) between two blocks, with the draft Agent Income Statements exclusions (zero, mints, self, optional owner top-ups), payers that are contracts flagged, and an optional claim= compared as matched or mismatched. Ethereum, Base and Robinhood Chain. Independent, by Blockpin; not a Claus Network service.","url":"https://check.blockpin.dev/income?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"],"type":"string"},"queryParams":{"type":"object","required":["chain","address","token","since"],"properties":{"to":{"type":"string","pattern":"^[0-9]+$","description":"Optional end block (default latest)"},"chain":{"enum":["ethereum","base","robinhood"],"type":"string"},"claim":{"type":"string","description":"Optional stated total to compare (token units)"},"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional owner address: its payments are excluded as top-ups"},"since":{"type":"string","pattern":"^[0-9]+$","description":"Start block (Ethereum: up to 1,000,000 back; Robinhood Chain: up to 7,000,000)"},"token":{"type":"string","description":"ERC-20 0x address, or native for ETH"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Agent wallet (agentWallet / payTo)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["summary","income","excluded","payers"],"properties":{"claim":{"type":["object","null"]},"income":{"type":"object"},"payers":{"type":"array"},"largest":{"type":"array"},"summary":{"type":"string"},"excluded":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BroO8wN764FlIsgwe4x_V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reconstructs an agent wallet's income from payments in a single asset (ERC-20 or native ETH) over a block range, filtering out mints, zero-value transfers, self-transfers, and optional owner top-ups, with contract-payer flagging and optional claim reconciliation.","exampleAgentPrompt":"Can you rebuild the income statement for my agent wallet 0xAbc...123 in USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Base from block 14000000 to block 14100000, excluding top-ups from owner 0xDef...456, and check whether it matches my claimed total of 500 USDC?","exampleUseCases":[{"title":"Agent earnings audit for billing period","prompt":"Rebuild the income for my agent wallet 0x1234...abcd in native ETH on Ethereum from block 19000000 to block 19500000 — exclude any top-ups from my owner address 0xOwner...5678 and flag any contract payers for me."},{"title":"Claim reconciliation before settlement","prompt":"My agent at 0xAgent...9999 claims it earned 1000 USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Base since block 13500000 — can you verify whether the on-chain income actually matches that figure?"},{"title":"Robinhood Chain agent income snapshot","prompt":"Show me all the income received by agent wallet 0xRobin...7777 in the RHN token (0xToken...aaaa) on Robinhood Chain from block 5000000 to the latest block, with a full list of payers."}],"resultDescription":"Returns a structured JSON object with a plain-English summary, a breakdown of qualifying income (amounts per payer, total), excluded transfers (zeros, mints, self-transfers, owner top-ups) with counts, a list of all payers with contract flags, the largest individual payments, and — if a claim was provided — a matched or mismatched status comparing the claimed total against the computed income.","failureModes":["Missing required params (chain, address, token, since) returns a 400-level error","Block range exceeding chain limits (e.g. >1,000,000 blocks back on Ethereum) may return an error or truncated results","Invalid token address or unrecognized chain enum returns an error","Payment required (402) if no x402-compliant payment header is included","Very large block ranges with high transfer volume may time out or return partial data","If the address has no qualifying income in the range, returns zero income with empty payer list"],"whenToPreferThis":"Use this endpoint when you need a clean, filtered income reconstruction for a specific agent wallet in a single asset over a defined block range — especially when you want automatic exclusion of noise (mints, zeros, self-transfers, owner top-ups), contract-payer flagging, and optional claim reconciliation. Prefer this over raw transfer queries or block explorers when building Agent Income Statements or auditing agent earnings on Ethereum, Base, or Robinhood Chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:56.930Z","isFirstParty":false,"canonicalSlug":"blockpin-agent-income-rebuild-843072b6"}