Robinhood Chain

Earliest KOL entry per token on Robinhood Chain (BASIC+)

The first time any tracked KOL bought each token on Robinhood Chain — an early-entry / discovery signal. Computed read-time from rhc_kol_trades (a DISTINCT-ON per token yielding the global earliest KOL buy), enriched with token metadata and current/peak MC. EVM-native fields (eth_amount, evm_address, tx_hash, 0x). Tier: BASIC — but below the API-access tiers (PRO/ULTRA/BUSINESS) limit is clamped to 20, and the first KOL's evm_address is revealed only to ULTRA/BUSINESS.

get/rhc/kol/first-touches

Request

  • Base URL: https://madeonsol.com/api/v1
  • URL: https://madeonsol.com/api/v1/rhc/kol/first-touches
  • Auth: HTTP bearer

Query parameters

limitinteger

Clamped to 20 for keys below the API-access tiers.

sincestring date-time

Only first-touches at/after this ISO8601 timestamp.

beforestring date-time

Cursor: only first-touches before this ISO8601 timestamp. Pass next_before to page.

cursorstring

PREFERRED pagination (audit F09 follow-up): the next_cursor from a previous page — an opaque strict (first_buy_at, id) keyset, so paging never repeats or skips rows that share a timestamp and progresses with limit=1 through runs of identical timestamps. Malformed or tampered → 400. Cannot be combined with before= (400); before= stays supported as the legacy bound.

min_ethnumber

Minimum ETH size of the first KOL buy (alias: min_sol).

token_age_max_mininteger

Only tokens younger than N minutes at first touch.

launchpadstring

Filter to one launchpad.

min_mc_usdnumber

Minimum MC at first buy (USD).

max_mc_usdnumber

Maximum MC at first buy (USD; alias: mc_max). Must be ≥ min_mc_usd.

Response

next_before is the pagination cursor (oldest first_buy_at on the page); data_age_seconds is the age of the newest event.

chain'robinhood'
countinteger
next_beforestring date-time nullable
next_cursorstring nullable

Opaque keyset cursor for the next (older) page — pass as cursor=. PREFERRED over next_before, which is a strict timestamp bound that skips same-timestamp siblings of the boundary row. null on a server that predates the rhc_kol_first_touches_page migration (legacy path: no id tiebreak).

has_moreboolean nullable

Exact (limit+1 probe). null when the server is on the legacy path and cannot tell — page on next_before until an empty page.

data_age_secondsinteger nullable

Changes

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