Live activity
Activity firehose (buys, sells, theses, ...) - REST
stalkchain_fomo_alerts · 125 credits
Ask: "What did frankdegods do in the last hour?"
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.
| Input | Type | Required | Description |
|---|---|---|---|
limit | integer | no | |
type | string | no | One of buy|sell|thesis|transfer|perp|listing|milestone|recap|whale|price|trade|follow |
chain | string | no | robinhood|solana|base|bsc|eth|monad|hyperliquid or raw chainId |
since | string or number | no | ISO timestamp or unix seconds/millis; returns alerts after this |
trader | string | no | Local filter by handle or userId |
tokenAddress | string | no | Local filter by token contract (or symbol) |
minUsd | number | no | Local filter on |usdValue| |
REST: POST /api/v1/tools/stalkchain_fomo_alerts with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_fomo_alerts?….
Sample the live WebSocket feed for N seconds
stalkchain_fomo_watch_stream · free
Ask: "Watch the live feed for 30 seconds and tell me what happened."
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
| Input | Type | Required | Description |
|---|---|---|---|
stream | alerts | trades | no | Default alerts |
durationSeconds | number | no | Default 20 |
maxEvents | integer | no | Stop early after this many live events (default 50); the replay is capped at the same number |
trader | string | no | Handle (alerts) or handle/wallet (trades) |
token | string | no | Symbol or contract address |
chain | string | no | robinhood|solana|base|bsc|eth|monad|hyperliquid (trades: robinhood|solana only) |
type | string | no | alerts only: buy|sell|thesis|perp|whale|price|trade |
source | feed | push | no | alerts only |
side | buy | sell | no | trades only |
minUsd | number | no | trades only: minimum fill size in USD |
includeReplay | boolean | no | Default true. false = drop the replay of recent history sent on connect and keep only live events |
REST: POST /api/v1/tools/stalkchain_fomo_watch_stream with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_fomo_watch_stream?….
Tokens several tracked traders entered in the same window (live)
stalkchain_fomo_multi_trader_entries · 125 credits
Ask: "Which tokens did 3+ tracked traders enter in the last hour?"
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.
| Input | Type | Required | Description |
|---|---|---|---|
windowMinutes | number | no | Look-back window (default 60) |
minTraders | integer | no | Default 3 |
side | buy | sell | no | Default buy |
chain | string | no | robinhood|solana|base|bsc|eth|monad or chainId |
watchSeconds | number | no | Also listen to the live stream this long (default 0) |
limit | integer | no | Max tokens to return (default 20) |
REST: POST /api/v1/tools/stalkchain_fomo_multi_trader_entries with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_fomo_multi_trader_entries?….