Tokens

GET /token/{address}/holders - which TRACKED the provider traders hold a token, ranked by USD value: (For the COUNT and the smart-money share of all holders, prefer stalkchain_fomo_kol_holders.) {handle, amount, valueUsd, priceUsd}. This is the 'which KOLs hold it' list. 250 credits. Populated from captured balances; available:false = nothing captured for this token yet. For a count + concentration summary use stalkchain_fomo_kol_holders instead.

The deployer and insiders of a token with their own positions. Answers 'are the insiders still in or did they exit', 'did the dev sell'. handle, wallet, isDev, amount, valueUsd, costBasisUsd, realized/unrealized PnL, averageEntryPrice, averageHoldTimeSeconds, tradeId, and the dev's own written thesis. A dev closing their bag shows here first. An EMPTY list means the provider knows of no dev holding, NOT that the token is safe. 250 credits.

How many buys versus sells on this token, and how concentrated are the holders. Buy/sell flow and pressure per window — use for one named token; to compare which tokens several traders entered use stalkchain_fomo_multi_trader_entries. Windows {5m,1h,4h,24h} each with buys, sells, uniqueBuyers, uniqueSellers, buyVolumeUsd, sellVolumeUsd, netVolumeUsd, buySellRatio; plus total holders and top10HoldersPercent. This is the volume/flow tool ('who was pushing it'). 250 credits.

Price chart data for a token — OHLCV candles for charting or technical analysis, down to 1-second resolution. resolution: 1S|15S|30S|1|5|15|30|60|240|720|1D|7D (minutes unless suffixed). Only answers where this deployment's data plan includes candles; otherwise it returns 402/403. When candles are not available, for a price series use stalkchain_price_history (any chain, daily/hourly/5-minute); for the current price stalkchain_token_prices_multichain, or stalkchain_fomo_search (priceUsd, marketCapUsd).

Are several traders piling into the same coin at once — a coordination and herding signal computed live. Use when the question is whether a move looks coordinated or organic; for a plain list of tokens with 3+ buyers in a window use stalkchain_fomo_multi_trader_entries. Which tokens several DISTINCT tracked traders bought (or sold) inside a window. Computed from the live alert firehose (125 credits), because the upstream activity board stopped updating on 2026-08-23. That board is still tried with a short 8 s budget and appended as providerBoard when it answers. Same output shape as stalkchain_fomo_multi_trader_entries.

How many tracked traders and KOLs hold this token, and what share of all holders is smart money. Answers 'do the KOLs have bags in this', 'is smart money in this ticker'. Use for who HOLDS it now; for who has been SELLING use stalkchain_fomo_kol_sell_pressure. Reads the tracked holders (FOMO traders holding it, by USD value) and the token's stats (total holders, top10HoldersPercent, 24h flow). Returns trackedHolderCount, trackedValueUsd, trackedShareOfHoldersPct (tracked / total holders), concentration, and the top holders. Percentage of SUPPLY is not derivable (the provider exposes no supply); percentage of holders is. ~500 credits (250 without stats).

Are the KOLs dumping this token. What share of the tracked holders have sold or exited recently, who sold, and who is still holding. Use when asked about selling, dumping, exiting or distribution; for who currently holds it use stalkchain_fomo_kol_holders. Combines the current tracked holders with recent sell alerts filtered to this token. A trader who sold EVERYTHING is no longer in the holder list, so the denominator is currentHolders + fullyExitedSellers. Returns sellersPct, whether thresholdPercent was crossed, who sold (with realized PnL from the alert), and who still holds. ~375 credits. Coverage is bounded by the alert ring (100 sells per call); the response states the time range actually covered.

Full research writeup on one COIN in a single call — the memo for a token, not a person (for a person use stalkchain_fomo_trader_report). Everything about one token in a single call — the default door for 'tell me about this coin', 'is this worth buying', 'research this token'. Prefer this over chaining stalkchain_fomo_token_stats + stalkchain_fomo_token_holders + stalkchain_fomo_token_devs, which costs more and tells you less. Research memo covering buy/sell flow over 5m/1h/4h/24h, total holders + top10 concentration, tracked smart-money holders, deployer/insider positions with rug flags, and (optional) the most-liked theses explaining WHY traders are in. Costs ~750 credits (stats+holders+devs), +1,250 with includeTheses. Pass chain for tokens outside the provider's directory. For a trending scan use stalkchain_fomo_trending_analysis.

Find what is trending right now and analyse it in one step. Use when no specific token is named and the ask is to go find something; when the user already has a coin, use stalkchain_fomo_analyze_token. Reads a token board (trending | graduated | most-held) then runs stalkchain_fomo_analyze_token on the top N (default 3, max 5). Cost: 250 + ~750 per token (+1,250 per token with includeTheses) - a 5-token scan with theses is ~10,250 credits, so keep N small on a tight budget. Filter by chain/marketCap to focus.

Who are the best traders holding these several tokens. Use for 2-5 tokens at once; for one token's holders use stalkchain_fomo_kol_holders. For each token (max 5) reads the tracked holders, unions them, and joins the leaderboard for the chosen window to attach rank and pnlUsd. Ranked by number of the given tokens held, then leaderboard PnL, then value held. 250 credits per token + 250 for the leaderboard. Wallets come from the leaderboard row when the trader is on it; otherwise use stalkchain_fomo_search (250) rather than stalkchain_fomo_resolve_trader (2,500).

Answers 'who launched this coin and when?' from the social-trading data: the token's dev list gives the deployer and insider handles, wallets, positions and their own thesis; the dev's trade is then opened to read when their position was opened (a proxy for launch time) and whether they have sold. Adds the token's stats for age context. ~500-1,000 credits. If no dev is known, the result says so; for the on-chain deployer of a Solana token use stalkchain_token_deployer.

Answers 'how do this token's holders change over time' - the provider has no history endpoint, so take snapshots and diff them with stalkchain_fomo_compare_snapshots. Returns {capturedAt, priceUsd, marketCapUsd, totalHolders, top10HoldersPercent, trackedHolders[{handle, amount, valueUsd}], flow24h}; price and market cap are live at capturedAt. ~500 credits. Save the JSON in your own store (file, DB) and call again later.

Pure local diff of two stalkchain_fomo_token_snapshot outputs: new tracked holders, exited holders, who increased/decreased their bag, change in total holders, top10 concentration and price. No API call.