KolHood documentation
KolHood watches wallets on Robinhood Chain (chain id 4663) and turns their swaps into answers: who is buying, who is selling, who is actually profitable, and which tokens more than one good trader is accumulating at the same time.
15,670 swaps in the last 24 hours across 135 wallets. The oldest swap held right now is from Aug 29, 08:21. History deepens while the indexer runs: it captures swaps as they happen rather than backfilling the chain, so "all time" means all time that KolHood has been watching.
How the numbers are produced
Realized PnL. Proceeds of each sell minus the average cost basis removed by that sell, summed over the selected period. Only closed size counts, so a position that has doubled but has not been sold contributes nothing.
Unrealized PnL. Open positions marked to the current indexed price, against the average price paid for the size still held.
Net flow. Value sold minus value bought over a window. It is not profit: it ignores the cost basis of everything still open. Where a data source can only report net flow, the column is labelled NET FLOW and never PnL.
Win rate. Share of closed sells that came out above their average cost basis. Open positions are excluded.
ROI. Realized PnL divided by the cost basis that was closed in the period.
KOL consensus. A token bought by three or more independent tracked wallets inside the selected window.
Activity spike. Four or more independent tracked wallets buying the same token within twenty minutes. Clustering is observable; intent is not. KolHood does not claim that traders coordinated.
Read API
Every screen in the product is built on these endpoints. They return JSON, are never cached, and take the same query parameters the UI uses.
/api/rhc/overviewTracked set summary: KOLs, 24h volume, trades today, active KOLs./api/rhc/tradesEvery indexed swap. Filters: side, minValueUsd, wallet, token, since, limit, offset./api/rhc/kol/feedSame as /trades, restricted to wallets in the KOL directory./api/rhc/kol/leaderboardRanked KOLs. Filters: period, minTrades, minVolumeUsd, minWinRatePct, sortBy, sortDir./api/rhc/kol/hot-tokensTokens ranked by independent KOL buyers in a window./api/rhc/kol/consensusTokens with three or more independent KOL buyers in a window./api/rhc/kol/coordinationClustered buying: four or more wallets inside twenty minutes./api/rhc/kol/first-touchesFirst ever buy of a token by a tracked wallet./api/rhc/kol/{wallet}Wallet performance, open positions and best closed trades./api/rhc/kol/{wallet}/seriesCumulative realized PnL or volume through time./api/rhc/kol/{wallet}/tradesTrade history for one wallet./api/rhc/tokensToken list with price, market cap, liquidity and KOL volume./api/rhc/tokens/{address}One token./api/rhc/tokens/{address}/candlesOHLC series for the price chart./api/rhc/tokens/{address}/kol-activityHolders, buyers and sellers in the last hour, plus net flow./api/rhc/tokens/{address}/kol-holdersTracked wallets with an open position./api/rhc/tokens/{address}/kol-consensusConsensus snapshot for one token./api/rhc/tokens/{address}/top-tradersWallets ranked by realized PnL on that token./api/rhc/tokens/{address}/flowBucketed KOL buy and sell value./api/rhc/alpha-walletsAlias of the leaderboard, kept for API compatibility./api/rhc/searchResolves an address, a handle, a ticker or a token name./api/rhc/streamServer-sent events. Emits `ready`, then `trades` batches as they are indexed./api/rhc/eth-priceETH spot from a public market source, cached for 30 seconds.Data sources
Chain. Robinhood Chain, an EVM chain with id 4663. Transaction and address links point at the Blockscout explorer.
Swaps. Real trades from the Pons launchpad markets, the venue where these tokens trade. Each record carries the trader address, side, token amount, USD value and the transaction hash, and every number on this site is aggregated from them.
Tokens. The same source publishes the market list: contract, ticker, name, logo, price, market cap and liquidity, refreshed every few minutes.
Identities. Nobody publishes a wallet to handle mapping for this chain, so a wallet stays an address until an operator links it in /admin. KolHood never guesses who owns a wallet, and one identity can hold several wallets.
ETH price. Binance spot, falling back to Coinbase. If both fail the ticker is hidden rather than showing a stale number.
Known limits
History starts when indexing did. A market returns only its most recent swaps and offers no pagination, so the archive is built forward from first run instead of backfilled.
Profit needs a visible entry. Selling a position bought before KolHood saw the wallet counts as volume, never as realized PnL. That keeps the leaderboard honest at the cost of understating a few early traders.
Coverage follows activity. Busy markets are polled every few seconds, the long tail on a rolling sweep, so a quiet token can lag by a few minutes.
Swapping the source
The product talks to one interface, not to a database. Point RHC_API_URL at a different Robinhood Chain data provider and the whole product follows, with no component changes. Setting HOODSCAN_DATA_SOURCE=mock runs the offline development engine instead, and every page says so while it is on.