Data coverage and limits

Honest limits of the data, so you can design around them.

• "KOL" and "tracked trader" mean traders the platform tracks and has captured balances for, not a curated influencer list.
• Percent of holders is computable; percent of supply is not (no total-supply field).
• Trade history is never complete. Positions return every open position but only the newest 25 closed per page; page with cursor, or use deep for a wider fan-out. closedTotalUpstream tells the real total.
• Windows are 24h, 7d, 30d and all-time only; arbitrary date ranges are not available.
• Following / followers are capped at 200 per trader by the source; sourceCapped flags it.
• Heavy accounts (hundreds of open positions) can time out upstream. We retry within 25 s, keep loading in the background, and serve the last good copy flagged [STALE …s] when we have one. Call again in 30–60 s for a fresh answer. These attempts cost nothing.
• Alert money fields: on a buy, usdValue is the position value after the fill (not the buy size); on a sell it is signed realized PnL. Use tradeUsd or stalkchain_fomo_trade_detail for fill size.
• Live stream samples are bounded (up to 120 s per call); there is no customer-facing WebSocket yet.
• StonkFun is free but shared-rate-limited; results are cached 30–60 s.
• Candles (OHLCV) require an upstream plan we do not currently include.