io.github.MadeOnSol/robinhood-chain

First buyers of a Robinhood Chain token, ranked, with still-holding status. Previously only readable as a count inside a wallet profile ('this wallet was an early buyer of N tokens') — this is the per-token ranked list. Added 2026-09-10. Tier: PRO+.

Net buy/sell flow on a Robinhood Chain token split by mutually-exclusive trader cohort — who is accumulating and who is distributing. SIGN CONVENTION: net_eth = sell MINUS buy, so a POSITIVE net_eth means that cohort DISTRIBUTED (took ETH out) and a NEGATIVE value means it ACCUMULATED. Do not invert this. Cohorts are assigned by a priority ladder and each trader lands in exactly one: kol, bot, dump_cluster, early_buyer, unprofiled, smart_money, retail. smart_money is DERIVED (win_rate >= 0.5 and net positive), not a stored label. unprofiled is a real answer, not missing data — that trader has not met the reputation thresholds yet. There is deliberately NO fresh_wallet cohort because Robinhood Chain stores no wallet-level first-seen. Tier: PRO+.

Exact holder set and concentration for a Robinhood Chain token. Balances are folded from ERC-20 Transfer logs — NOT derived from trades — and reconciled against on-chain totalSupply() at a pinned block. ALWAYS CHECK verified FIRST: false means the reconstruction is incomplete for that token and unverified_reason explains why (a token that only recently became liquid legitimately has partial history); do not present unverified numbers as exact. Concentration (top1/top10/top50 share, hhi, deployer_pct) EXCLUDES liquidity pools and burn addresses from the circulating denominator, because the largest holder of a token is normally its own pool; those are reported separately as pool_held_pct and burned_pct. balance is a raw uint256 returned as a decimal STRING — never coerce it to a float, it exceeds 2^53. Holder addresses may be ERC-4337 smart accounts, so holder_count is not a headcount of people. holder_growth.{1h,24h,7d} reports entered (first Transfer at-or-after the window's cutoff_block), entered_still_holding, exited (pre-existing holders whose last Transfer in the window left them at zero) and net = entered_still_holding − exited ≈ change in holder_count — pools/burns excluded; a window is null only when the chain had no ingested trades in it, the whole object null only if the growth read failed. Tier: PRO+ (50 rows; ULTRA/BUSINESS raises the cap to 200).

Robinhood Chain KOL consensus on a token — distinct KOL buyers vs sellers, exit rate (bought AND sold), net ETH flow (net_flow_eth), median entry MC, and first-touch wallet/time. ULTRA additionally returns the buyers and exited wallet lists. consensus is null when no tracked KOL has traded the token. Tier: PRO+.

Every tracked-KOL trade on one Robinhood Chain token in one payload, newest first (keyset paged with next_cursor + has_more): kol_name, wallet, action, eth_amount, token amount, price and market cap at the trade, tx_hash, log_index, block_number, dex. include_balances (PRO+) adds each KOL's CURRENT balance from balanceOf on our node (unverified with a reason when a read fails, never 0, never reconstructed from trades). Tier: BASIC (5-min delayed, 20 rows), PRO+ real time.

Every lock / vesting contract on ONE Robinhood Chain token with a live summary — 'did the team lock, how much, until when, can they cancel'. summary covers the token-subject rows: locked / deposited (raw + ui + usd + % of supply), unlocking_7d_* / unlocking_30d_* (forward schedule), nearest next_unlock, active_cancelable_by_sender (funds are locked against the RECIPIENT, not the locker, when the sender can cancel), counts by family / kind, distinct depositing wallets; LP locks on the token's pools are counted APART (lp_lock_count) because their amounts are pair units. Rows active-first, largest locked first. token.facts_resolved:false means decimals are unknown and every ui/usd/pct is null — say so rather than reading 0. Same create-only caveat as rhc_token_locks (withdrawals not tracked). Rows carry the same provider (verified only by contract address; compatible = ABI match, operator not identified) / explorer / price_usd / seconds_until_* fields. Tier: PRO+.

Robinhood Chain TOKEN LOCKS & VESTING feed — newest lock / vesting contracts CREATED on chain across all tokens, newest first, decoded from the locker contracts' own events on our own node (PinkLock-compatible, HoodLock + vesting, Team Finance-compatible, Titan Locker, UNCX-compatible LP lockers, Sablier Lockup v4). Each row carries the on-chain schedule (start_at / cliff_at / end_at, cliff_amount, tranche `schedule`) and a LIVE derived view: locked_* (still locked right now), unlocked_*, next_unlock {at, kind cliff|final|tranche, amount}, status active|completed. `sender` is the depositor/creator — compare it with the token's deployer (rhc_token) to call a DEV LOCK; `recipient` is the beneficiary when different; cancelable_by_sender comes from Sablier's flag (null where the family does not say). Amounts are RAW base units as decimal STRINGS — never coerce to floats; ui/usd/pct are null when decimals or price are unknown. CREATE-ONLY TAPE: withdrawals and cancels are NOT tracked (no RHC locker publishes a verified release event) — `withdrawn` is null (unknown), never 0, and coverage.withdrawals_tracked is false; never present a lock as 'still held' beyond what the schedule says. LP locks (RHC launchpads auto-lock LP on every launch — noise) are excluded unless subject='lp'|'all', carry pair/liquidity units and never claim usd/pct. Cursor: pass pagination.next_since back as `since` to poll for newer, pagination.next_cursor as `cursor` to page back (strict, no skips; legacy `before` skips same-timestamp rows). PROVENANCE (2026-10-02): provider {id, name, identity, compatible_with, website_url, lock_url} is decided by the locker CONTRACT ADDRESS, never by family: identity 'verified' only for known provider deployments (HoodLock vault + vesting, Sablier Lockup v4, Titan Locker V2.1); 'compatible' means only the event ABI matches (compatible_with names the shape) and the operator is NOT identified — never call a compatible locker by the provider's name as fact. lock_url…

Peak market cap, drawdown from peak, and a running high-water MC curve for a Robinhood Chain token. IMPORTANT: TWO peaks are returned because they disagree. peak_mc_usd_recorded is the stored high-water mark that every other RHC surface keys off (deployer runner-rate, the $40K graduation bar); it is sampled from write batches so it can UNDERCOUNT an intra-batch spike. peak_mc_usd_observed is the maximum of 1-minute candle highs — trade-level truth, and always >= recorded. Report whichever the user needs but do not treat them as interchangeable. Candle history begins 2026-07-15, so check observed_covers_full_history before calling the observed value a lifetime maximum. running_peak_mc in the curve is monotonically non-decreasing by construction. Tier: PRO+.

EVM-native risk assessment for a Robinhood Chain token, computed LIVE against a self-hosted RHC node. THIS IS NOT THE SOLANA RISK MODEL: EVM has no mint or freeze authority. Across 300 random RHC tokens only 2.3% even expose an owner() function and 0% expose mint in their own bytecode — so an ABSENT capability flag is the NORM and is NOT a safety signal. Never tell a user a token is safe because can_mint is false. The signals that actually discriminate are proxy upgradeability, LP custody and above all sellability: sellability.sellable is simulated at the chain head through the router and is never cached, because whether a token can be sold changes the moment an owner flips a setting. 'no' means bought-but-cannot-sell (honeypot-shaped). Note owner.model 'none' (no owner function exists at all) is a DIFFERENT answer from 'renounced'. lp_custody is only read for uniswap-v2 pools; v3/v4 liquidity sits in an LP NFT and reports 'unknown' rather than being guessed. Tier: PRO+.

Top traders of one Robinhood Chain token, ranked by REALIZED ETH flow, enriched with wallet reputation (win_rate, likely_bot, is_known_kol, kol_name), dump-cluster membership and early-buyer rank. CRITICAL: net_eth is sell_eth MINUS buy_eth — realized flow, NOT PnL. It does not value a trader's remaining bag, so a wallet that bought and still holds ranks LAST, not first. Do not present net_eth as profit. For FIFO cost-basis PnL use the wallet PnL endpoint instead. Tier: PRO+ (50 rows; ULTRA/BUSINESS raises the cap to 200).

Upcoming unlock EVENTS across all active Robinhood Chain lock / vesting contracts — which tokens have supply hitting the market inside the window, how much, from whose lock. One entry per active contract = its NEXT cliff / tranche / final unlock inside within=1h..90d, with amount_* (the event, raw / ui / usd / % of supply) and window_amount_* (that contract's total release over the whole window). Linear per-second streams contribute cliff / final events only. Token subject only (LP excluded). Prices implying a market cap above $100B are treated as phantom → usd null. Tier: PRO+.

Robinhood Chain token discovery — live-priced tokens with market cap, liquidity, peak MC + drawdown, launchpad, and deployer reputation tier. Sortable and filterable. Tier: PRO+.

Robinhood Chain DEX trade tape — every Uniswap v2/v3/v4 swap on chain 4663, ~sub-second from execution. Each row carries the effective trading account in trader_eoa, plus gas/ordering for MEV analysis, pool state, and is_kol / deployer_tier flags. Cursor via next_before. Tier: PRO+. IMPORTANT — trader_eoa is NOT simply tx.from: on an ordinary transaction it equals tx.from, but when the trade was bundled through ERC-4337 it is the userOp sender (from UserOperationEvent), never the bundler/relayer that submitted the batch and never the router. It is still an EOA either way — on Robinhood Chain a userOp sender is an ordinary EOA carrying an EIP-7702 delegation, not a smart-contract wallet. Always attribute a trade to trader_eoa; the separate trader field is only the swap-log recipient (the router on aggregated swaps).

Robinhood Chain wallet profile — any wallet's 90-day trading profile: FIFO cost-basis PnL, per-token breakdown, recent trades, and a reputation block (is_kol, is_deployer + deployer_tier, is_alpha_tracked, dump-cluster membership, early_buyer_tokens). Denomination is ETH, not SOL or USD. IMPORTANT: stats.unattributed_trades counts pre-2026-07-18 rows whose trader_eoa is NULL — those are unattributable by design and are excluded from every PnL figure, so a low analyzed_trades on an old wallet is a data-window limit, not inactivity. stats_unavailable=true means the snapshot timed out (flags still resolve). stats.held_value_eth, open_positions and top_tokens[].still_holding are FIFO figures (DEX buys not matched by a DEX sell), NOT balances: holdings (verified_value_eth, held / transferred_or_disposed counts) and top_tokens[].holding_status check them against the chain via balanceOf on our own node, so quote holdings.verified_value_eth for what the wallet holds now. A contract address returns 404 with address_type=contract. Tier: PRO+.

Robinhood Chain wallet FIFO cost-basis PnL over 90 days — realized/unrealized split, a daily realized curve (pnl_curve), every closed position with roi_pct and hold_minutes, and every open position marked to the current price. Same FIFO implementation as the Solana /wallet/{address}/pnl, so the two chains are directly comparable. IMPORTANT: notes.cost_basis_observable_from is the date the window opens — buys before it are invisible to cost basis, which is why a long-held position can appear as a sell with no matching buy. Check notes.partial before quoting totals. Amounts are ETH. Tier: PRO+.

Robinhood Chain wallet open positions — FIFO-open positions (DEX buys not matched by a DEX sell) marked to the current price, each checked against the chain. Same FIFO pass as rhc_wallet_pnl without the curve and closed positions; use this for 'what is this wallet in right now'. IMPORTANT: a FIFO-open position is not a balance — read positions[].holding_status: HELD, PARTIALLY_REDUCED, TRANSFERRED_OR_DISPOSED (sent away, balance 0), EXTERNAL_INFLOW (more than was bought; the excess has no cost basis) or BALANCE_UNVERIFIED (read failed: no value, never assume held); current_onchain_balance is the balanceOf from our node and summary.holdings.verified_value_eth counts proven balances only. IMPORTANT: positions[].liquidity_basis='v4_virtual_ceiling' means liquidity_usd is a bonding-curve VIRTUAL ceiling, not withdrawable TVL — never size an exit against it; 'measured' means real pool reserves. summary.unpriced_positions are excluded from the value and unrealized totals. Amounts are ETH. Tier: PRO+.

ADD a wallet to your Robinhood Chain watchlist (POST — this writes and consumes your per-chain quota). The address is stored lowercase so it matches rhc_trades.trader_eoa; a checksummed 0xAbC… would join to nothing and the wallet would look permanently silent. Returns 409 if the wallet is already tracked, and 403 once you are at your tier cap. Tier: PRO+.

List the wallets on your Robinhood Chain watchlist. Quotas are PER CHAIN — PRO 50 / ULTRA 100 / BUSINESS 500 RHC wallets, independent of your Solana watchlist, so adopting RHC never shrinks an existing Solana list. Returns each wallet_address, label and added_at, plus count/limit/remaining. Tier: PRO+.

WRITES — change the label on a tracked Robinhood Chain wallet. Pass label=null to clear it (unlike the add tool, null IS accepted here). Returns 404 if the wallet is not on your watchlist. Tier: PRO+.

DESTRUCTIVE — permanently remove a wallet from your Robinhood Chain watchlist. Frees one slot against your per-chain quota. Returns 404 if the wallet is not on your list. Tier: PRO+.

Per-wallet buy/sell/volume rollup across your tracked Robinhood Chain wallets. Sourced from rhc_trades DIRECTLY, not from a per-subscriber capture log — on RHC every swap is already recorded, so adding a wallet gives you its full history immediately rather than only from the moment you started tracking it. (The Solana tracker cannot do this: there, trades are only captured for wallets somebody asked for.) stats_unavailable=true means the rollup timed out and the per-wallet stats are zeroed, not absent. Tier: PRO+.

Merged trade feed across every wallet on your Robinhood Chain watchlist, newest first, each row labelled with its watchlist label. The cursor (next_before) is an opaque keyset matching the rest of the RHC tree, NOT the Solana tracker's integer epoch. A `wallet` filter must already be on your watchlist or the call returns 400. Tier: PRO+.

Robinhood Chain single-wallet trade tape — one wallet's swaps, newest first, cursor-paginated on an opaque next_before keyset. Distinct from rhc_trades with a token filter: that filters the GLOBAL tape by token, this filters by WALLET (a different index path). Pass the previous response's next_before back as `before` to page; it is an opaque cursor, not an offset. Tier: PRO+.