Skip to content

Read a coin: holders, risk, chart

Everything the coin page on uprally.co shows, as JSON.

Terminal window
COIN=0x94641b97010608c3827fb058074889f19868ff33
curl https://uprally.co/api/v1/coins/$COIN # profile, market, curve, risk, contract checks, pools
curl https://uprally.co/api/v1/coins/$COIN/holders # holders & risk
curl "https://uprally.co/api/v1/coins/$COIN/candles?tf=5m&limit=100"
curl https://uprally.co/api/v1/coins/$COIN/trades # its latest trades, on every app
curl https://uprally.co/api/v1/coins/$COIN/traders # its traders, by profit
curl https://uprally.co/api/v1/coins/$COIN/creator # who launched it, and how they trade

/holders counts every holder from the coin’s launch block, so the balances add up to its whole supply (or the answer says it could not: never a partial list). It names:

  • the creator: the wallet that signed the launch, with the launchpad’s launcher contract counted as the same account; what it bought, holds and burned;
  • bundled: wallets that got coins in the launch transaction itself, or 3+ wallets whose first buy landed in the same block soon after;
  • snipers: wallets whose first coins came within 30 blocks (about 3 seconds) of the launch;
  • for each group, what it bought, what it holds now, and a level: amber or red when it holds a large share.

/holders/bundled and /holders/snipers list each group’s wallets, and together when 3 or more of them sold in one transaction (one controller).

Holders are counted for coins launched since 14 October 2026; an older coin answers { "tracked": false, "reason": "notFromLaunch" }. The rules in full: Holders & risk.

  • GET /coins?sort=volume|marketCap|new|activity: every coin with a market, paged with cursor. Filter with minHolders, maxBundledHeldPct and maxSnipersHeldPct.
  • GET /coins/new: launches newest first; poll with since.
  • GET /search?q=: by name, ticker or address.
  • GET /smart-money, GET /top-traders: wallets that keep winning, and the biggest winners right now.
  • GET /wallets/{address}: one wallet’s profit and loss on Robinhood coins.

The whole file: read-a-coin.mjs.