Robinhood Chain

First buyers of a Robinhood Chain token, and whether they still hold (PRO+)

The first buyers of a Robinhood Chain token, in order, joined to what happened next. rhc_early_buyers ranks the first 20 buyers of 437k tokens and is recomputed daily; until now it was read only as a per-wallet COUNT, never exposed as a per-token list. The Solana counterpart is GET /kol/tokens/{mint}/entry-order.

realized_eth is observed sell-minus-buy ETH cashflow, NOT validated FIFO realized PnL. Missing earlier buys, transfers and source gaps affect cost basis; read position and holding evidence separately.

Default still_holding requires a successful holder fold and a supply reconciliation. On failed/partial source it is null, not an invented exit. Optional verify_current_balances=true (ULTRA+) checks every ranked first buyer via balanceOf on the existing private Hood node at one pinned block with a matching block-hash recheck. If any RPC call, block check or the ranked cohort/statistics is unavailable, the whole strict request fails (503) rather than returning partially verified balances. Maximum 20 wallets; additional RPC is opt-in only. holder_recon_block/holder_recon_checked_at refer to the separate existing fold, not atomic chain-head balance proof.

Ranks are as of computed_at, not live. A token that began trading after the last sweep returns an empty list with a stated reason - never an assertion that it had no early buyers. Wallets may be ERC-4337 smart accounts, so a wallet is an address, not a person.

get/rhc/tokens/{address}/early-buyers

Request

  • Base URL: https://madeonsol.com/api/v1
  • URL: https://madeonsol.com/api/v1/rhc/tokens/{address}/early-buyers
  • Auth: HTTP bearer

Path parameters

addressstring required

Token address (0x, 40 hex).

Query parameters

limitinteger

Ranking depth is 20 by construction.

verify_current_balancesboolean

ULTRA+ opt-in: 1 existing Hood-node batch of ≤20 ERC-20 balanceOf calls at a pinned block; all verified or 503, never a partially verified panel. No new RPC traffic by default.

include_scout_scoresboolean

PRO+ opt-in (2026-10-15): adds is_kol and scout_score per buyer. A KOL buyer's scout score is computed as of its own first_buy_at, so it shows what was knowable when it bought, not hindsight. Method as GET /rhc/kol/scouts/leaderboard. A failed read sets scout_scores_status and leaves the fields null, never the rest of the response.

Response

OK. An empty early_buyers array with a note means the token is not yet ranked.

chain'robinhood'
token_addressstring
scout_scores_status'ok' | 'unavailable' | 'timeout' | 'error'

Only with include_scout_scores=true. unavailable = hood rhc/038 not applied.

scout_scores_notestring

Only with include_scout_scores=true: the scout score method.

countinteger
computed_atstring date-time nullable
holdings_verifiedboolean nullable

True only when the holder read succeeded AND token supply reconciles at a previously checked block.

holder_recon_blockinteger nullable

Block of the latest supply reconciliation; no atomic snapshot guarantee for holder rows.

holder_recon_checked_atstring date-time nullable
notestring

Present only when the list is empty.

Changes

No recorded changes to this operation across all 1 revision of this API.