{"uid":"cap_YhPsKBABFZCds7gpIBYRN","slug":"beggar-bot-aggregate-share-endpoint-base-mainnet-3a8b8ad3","name":"Beggar Bot Aggregate Share Endpoint (Base Mainnet)","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/aggshare?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"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_VmbNjsPETOa2s01UVU3rf","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 aggregated share or distribution analytics for USDC activity on Base mainnet, paid via x402 micropayment.","exampleAgentPrompt":"Can you pull the aggregate share analytics for USDC on Base mainnet from Beggar Bot — I want to see the overall distribution breakdown?","exampleUseCases":[{"title":"USDC distribution snapshot on Base","prompt":"Get me the aggregated USDC share data on Base mainnet right now — I want to understand how holdings are distributed across the network."},{"title":"Compare Base vs Base Sepolia share stats","prompt":"Fetch the aggregate share metrics for USDC on Base Sepolia testnet using Beggar Bot so I can compare them against mainnet figures."},{"title":"DeFi portfolio concentration analysis","prompt":"Pull the Beggar Bot aggshare data for USDC on Base mainnet so I can analyze whether holdings are concentrated or broadly distributed before making a liquidity decision."}],"resultDescription":"A JSON object containing aggregated share or distribution statistics for USDC on Base mainnet (or Base Sepolia if specified), reflecting on-chain data such as holder distribution, concentration metrics, or flow aggregates.","failureModes":["Payment not received — x402 payment of $0.02 USDC to the specified payTo address must be completed before data is returned","Invalid network parameter — only 'base' (default) or 'base-sepolia' are supported","Malformed properties query parameter — input schema expects a string under 'properties'","Upstream Base RPC failure — on-chain data may be temporarily unavailable","Insufficient USDC balance — calling agent wallet lacks funds to complete micropayment"],"whenToPreferThis":"Use this endpoint when you need aggregated share or distribution-level analytics for USDC on Base mainnet and are comfortable with a $0.02 USDC x402 micropayment per call. Prefer this over raw RPC calls when you want pre-computed aggregate metrics rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:33:37.807Z","isFirstParty":false,"canonicalSlug":"beggar-bot-aggregate-share-endpoint-base-mainnet-3a8b8ad3"}