token-holder-cohorts, wallet-sell-classify, token-overhang, and
wallet-cohort-label now cover Ethereum, Base, Ink, and Robinhood Chain.
token-holder-dossier combines holder cohorts, overhang, ERC-20 metadata, and
token risk data in one response.
The cohort route costs $0.03 USDC. It uses the pool-creation time to separate holders that entered before the pool opened from a snipe window derived from the observed entry data. It returns positions, entry times, and later activity for the sampled holder set.
wallet-sell-classify costs $0.02 USDC. The naive sold percentage counts every
outbound transfer as a sale, including self-custody rotation and bridge
deposits. The route classifies counterparties and returns that percentage
beside the real-sell percentage. Separate amounts cover rotation, bridge-out,
CEX deposits, EOA transfers, and unknown flow.
token-overhang costs $0.02 USDC. It compares the top non-infrastructure
holders' token value with indexed pool liquidity and reports the resulting
ratio. Set confirm_balances to re-read up to 10 included holder balances and
total supply from the chain. Confirmed values replace the indexed values in
the calculation, and differences above 0.5% appear in balance_drift. An RPC
failure leaves the indexed result available with a confirmation note.
wallet-cohort-label, also $0.02 USDC, reports supported wallet facts such as
an EIP-7702 smart account, infrastructure address, marker-token holding,
relayed status, or inactivity after token entry. Its default ERC-20 count is
an upper bound because unsolicited receipts are included. Set
classify_portfolio to check up to 15 top balances: a token with an outbound
transfer or at least two inbound transfers is acquired, while one inbound and
no outbound is airdrop-shaped. Labels that need unvalidated behavioral
thresholds stay withheld with their reason.
holder-hands now excludes locked LP, treasury Safes, and pool infrastructure
from NFT concentration math. Those addresses remain visible in excluded, so
the changed denominator can be checked. Whale rows also show EIP-7702
smart-account status. Ordinary users may use these accounts.
Confidence fields distinguish indexed facts from method-dependent labels. Balances, entry timestamps, transfer volumes, and EIP-7702 status carry high confidence. Cohort boundaries and counterparty labels carry medium confidence. Labels that need outcome data are withheld with a reason.
token-holder-dossier costs $0.08 USDC. Send token_address, an optional
chain, and top_n to get cohort, concentration-versus-liquidity, metadata, and
risk components with their status and any degraded result.
These routes return data and risk telemetry, not investment advice.