{"uid":"cap_l35vDmmjMeAB2uOkztiIS","slug":"httpay-xyz-token-holder-monitor-4948c364","name":"httpay.xyz Token Holder Monitor","description":"Token Holder Monitor — tracks top 10 holders, whale distribution & concentration (HHI) for any token. Params: ?token=USDC&chain=base. Demo: ?demo=true.","url":"https://httpay.xyz/api/token-holder-monitor","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"description":"Token Holder Monitor — tracks top 10 holders, whale distribution & concentration (HHI) for any token. Params: ?token=USDC&chain=base. Demo: ?demo=true."}},"example":{"request":{"chain":"base","token":"USDC"},"response":{"demo":false,"meta":{"x402":true,"poweredBy":"Alfred Zhang 🫡"},"note":"Live holder data requires Basescan Pro API key — showing representative demo data. Set BASESCAN_API_KEY in environment for live data.","chain":"base","token":"USDC","errors":["Holder API: NOTOK"],"fetchedAt":"2026-06-12T04:16:36.630Z","topHolders":[{"rank":1,"type":"protocol","label":"Aave: USDC Pool (Base)","address":"0xa238Dd80C259a72e81d7e4664a9801593F98d1c5","balance":"1200000000.00","pctOfSupply":"26.67"},{"rank":2,"type":"protocol","label":"Moonwell: cUSDC Pool","address":"0x47cbe25bbdb40a774cc37e1da92d10c2c7ec897f","balance":"850000000.00","pctOfSupply":"18.89"},{"rank":3,"type":"protocol","label":"Morpho: USDC Market","address":"0x9c4ec768c28032803d9a38a8346f597e8949c0a6","balance":"620000000.00","pctOfSupply":"13.78"},{"rank":4,"type":"custodian","label":"Circle (Mint Reserve)","address":"0x55fe002aeff02f77364de339a1292923a15844b8","balance":"400000000.00","pctOfSupply":"8.89"},{"rank":5,"type":"exchange","label":"Coinbase Exchange","address":"0x3cD751E6b0078Be393132286c442345e5dc49699","balance":"280000000.00","pctOfSupply":"6.22"},{"rank":6,"type":"dex","label":"Uniswap V3: Router","address":"0x2626664c2603336e57b271c5c0b26f421741e481","balance":"150000000.00","pctOfSupply":"3.33"},{"rank":7,"type":"dex","label":"Aerodrome LP","address":"0xcf77a3ba9a5ca399b7c97c74d54e5b1beb874e43","balance":"95000000.00","pctOfSupply":"2.11"},{"rank":8,"type":"unknown","label":"Unknown Whale","address":"0x6Ac7f77ef6a929c8EaE7aaa7400C9830c66E5900","balance":"62000000.00","pctOfSupply":"1.38"},{"rank":9,"type":"unknown","label":"Unknown Whale","address":"0x1B7BA42Ab36Fd5D3f40A7c27E26b05d63c1e8c17","balance":"44000000.00","pctOfSupply":"0.98"},{"rank":10,"type":"unknown","label":"Unknown Wallet","address":"0xfA9423D559a688cCEfe0fcE6d6f8aE3E91E9e5A2","balance":"28000000.00","pctOfSupply":"0.62"}],"totalSupply":"4500000000.000000","concentration":{"insight":"Top 3 holders control 59.3% of supply — mostly DeFi protocols. Concentration is healthy for a stablecoin (protocols lock USDC for lending).","hhiIndex":1247,"hhiLabel":"Moderately Concentrated","top10SharePct":"82.87"},"contractAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","totalSupplyFormatted":"$4.5B"}},"exampleRequest":{"chain":"base","token":"USDC"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LJRXNP49Guc4mnHTjNqPf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Tracks the top 10 holders, whale distribution, and concentration (HHI) for any token on a specified chain","exampleAgentPrompt":"Show me the top 10 holders of USDC on Base and tell me how concentrated the ownership is — I want to know the HHI and whether whales dominate the supply.","exampleUseCases":null,"resultDescription":"Returns a ranked list of the top 10 token holders with their addresses and balances, whale distribution breakdown, and a Herfindahl-Hirschman Index (HHI) score indicating how concentrated token ownership is.","failureModes":["Unknown or unsupported token symbol returns an error or empty result","Unsupported chain identifier returns a validation error","On-chain data temporarily unavailable causes a timeout or partial result","Demo mode returns synthetic data not reflecting real holders","Malformed request (missing token or chain param) returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need a quick snapshot of token holder concentration, whale dominance, and top-holder rankings for a specific token on Base or another supported chain. Prefer this over generic block explorers when you need the HHI concentration metric computed automatically alongside ranked holder data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:17.742Z","isFirstParty":false}