Live activity

What is hitting the live feed right now — the raw activity firehose of buys and sells as they happen. For whether several traders are converging on ONE coin, use stalkchain_fomo_coordinated_activity. Newest-first feed of every buy/sell/thesis/transfer/listing/perp/milestone/recap, 125 credits per call (100 items ~ 10 minutes of activity). Each: alertType, source (feed|push), eventId (dedupe key), userId, tradeId, trader (handle), token, tokenAddress, chainId, chain, usdValue, text, ts. MONEY CAVEAT: on a BUY usdValue is the POSITION mark after the fill (not the buy size); on a SELL it is signed realized PnL; use tradeUsd when present or stalkchain_fomo_trade_detail for the fill size. Server filters: type, chain, since (ISO or unix; the API returns at most the newest 100 matching items, so a long window is not fully covered - narrow by type/chain). Local filters: trader, tokenAddress, minUsd. For live data use stalkchain_fomo_watch_stream.

Samples the live activity feed: stream=alerts is the app feed (every buy, sell and thesis as it is posted; it can run a few seconds behind, depending on this deployment's data plan), stream=trades is the on-chain fill feed (about 15 s ahead of the app feed, only where the data plan includes it; otherwise the stream is refused). Applies server-side filters, collects events for up to durationSeconds (max 120) or until maxEvents, then returns them. Streams cost 0 credits. Alerts carry eventId/userId/tradeId/tokenAddress/chain/usdValue/text; on-chain trades carry txHash, block, real fill usdValue, trader {wallet, handle}. Use for 'what is happening right now', to confirm a trader's live activity, or to watch a token. On connect the server replays recent matching alerts (flagged replay:true); they are included by default so a short sample is never empty - set includeReplay=false for strictly-live events. The replay never ends the sample: maxEvents counts live events only. liveCount, replayCount, newestReplayAt and heartbeats show whether the feed is flowing.

Which tokens did several tracked traders buy in the same window. Answers 'which coins did 3+ traders ape into in the last hour' / the polling form of 'notify me when three traders enter the same token'. Pulls the recent buy (or sell) alerts in the window (125 credits) and groups by token, counting DISTINCT traders (by userId). Optionally also samples the live WebSocket for watchSeconds to catch entries happening right now (0 credits). Returns tokens with >= minTraders, their traders, first/last entry time, chain. Coverage: one REST page is 100 alerts (~10 min of all activity, longer when filtered by type/chain); the response says exactly which time range was covered, so shrink the window or filter by chain if truncated. usdValue on buys is the position mark, not the buy size.