{"name":"token-holder-cohorts","description":"Token holder cohort analysis for an ERC-20 on Ethereum, Base, Ink, or Robinhood Chain. Shows who bought before the pool opened, the data-derived snipe window, day-one and later holders, positions, and entry timestamps. Locked LP, treasury Safes, and pool infrastructure are excluded from cohort totals and reported separately. EIP-7702 smart accounts are detected without treating them as bots. Use it as a token holder cohort analysis or to find who bought before the pool opened. Data only, not investment advice.","price":"$0.03","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 non-infrastructure holders, 1-50."}},"required":["token_address"]},"input_example":{"token_address":"0x4200000000000000000000000000000000000006","chain":"base","top_n":25},"output_example":{"chain":"base","token":{"address":"0x4200000000000000000000000000000000000006","name":"Wrapped Ether","symbol":"WETH","decimals":18,"total_supply":"1000000000000000000","holders":25000},"pool":{"opened_at":"2026-08-30T09:07:33.000Z","deployed_at":"2026-08-29T23:57:33Z","source":"dexscreener","pair_address":"0x1111..."},"cohorts_available":true,"snipe_window_seconds":780,"cohorts":{"pre_pool":{"count":3,"pct_of_supply":18.2},"snipe":{"count":7,"pct_of_supply":9.1},"day1":{"count":11,"pct_of_supply":4.3},"later":{"count":4,"pct_of_supply":1.2},"unknown":{"count":0,"pct_of_supply":0}},"holders":[{"address":"0x2222...","position_pct_supply":8.1,"entry_ts":"2026-08-30T08:59:00Z","last_activity_ts":"2026-08-30T09:10:00Z","cohort":"pre_pool","is_contract":false,"smart_account":null,"truncated":false}],"excluded":[{"address":"0x3333...","class":"pool","label":"Uniswap v4 PoolManager","confidence":"medium","position_pct_supply":2.69}],"truncated":false,"partial":false,"partial_reason":null,"sample":{"holders_scanned":26,"upstream_calls":31,"truncated":false},"confidence":{"cohort":"medium","position":"high"},"withheld_labels":[{"label":"behavioral prediction","reason":"LOW confidence: no labeled outcome data."}],"disclaimer":"Data and risk telemetry, not investment advice."},"x402_payment_required":true,"x402_facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}