{"name":"token-overhang","description":"Measures holder concentration versus liquidity for an ERC-20 on Ethereum, Base, Ink, or Robinhood Chain. It answers can the float exit by comparing the top non-infrastructure holders' USD value with DexScreener liquidity, then returns a deep, moderate, thin, or extreme ratio. Locked LP, treasury Safes, and pool infrastructure are excluded and listed separately. Use it as a holder concentration vs liquidity check or to ask whether the float can exit. Optional on-chain balance confirmation detects indexer drift and substitutes confirmed values. Data only, not investment advice.","price":"$0.02","method":"POST","input_schema":{"properties":{"token_address":{"type":"string","description":"0x-prefixed ERC-20 address."},"chain":{"type":"string","enum":["ethereum","base","ink","robinhood"],"default":"base","description":"EVM chain."},"top_n":{"type":"integer","minimum":1,"maximum":50,"default":25,"description":"Top holders, 1-50."},"confirm_balances":{"type":"boolean","default":false,"description":"Confirm up to 10 included holder balances and total supply by on-chain RPC reads."}},"required":["token_address"]},"input_example":{"token_address":"0x4200000000000000000000000000000000000006","chain":"base","top_n":25,"confirm_balances":true},"output_example":{"chain":"base","token":{"address":"0x4200000000000000000000000000000000000006","name":"Wrapped Ether","symbol":"WETH","decimals":18,"total_supply":"1000000000000000000"},"top_n":25,"holdings":{"top_n_pct_supply":32.5,"top_n_units":325000,"top_n_value_usd":812500},"market":{"price_usd":"2.50","liquidity_usd":100000,"fdv":2500000,"pair_address":"0x1111...","source":"dexscreener"},"overhang_ratio":8.125,"verdict":"thin","verdict_basis":"ratio thresholds are heuristic, not calibrated","excluded":[{"address":"0x3333...","class":"locker","label":"V2LaunchLocker","confidence":"high","position_units":81600,"position_pct_supply":8.16}],"priced":true,"balances_confirmed":true,"balance_drift":[{"address":"0x4444...","indexer_value":"325000000000000000000000","chain_value":"320000000000000000000000","drift_pct":1.538461}],"confirmation_note":null,"partial":false,"partial_reason":null,"confidence":{"top_n_holdings":"high","overhang_ratio":"high"},"disclaimer":"Data and risk telemetry, not investment advice."},"x402_payment_required":true,"x402_facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}