Traders
Search traders and tokens
query Parameters
qHandle, display name, token symbol or token name
Handle, display name, token symbol or token name
typeRestrict result type (default all)
Restrict result type (default all)
limitSearch traders and tokens › Responses
{ data, notes?, credits, meta }
Search traders and tokens
Which wallets belong to this handle — look up a trader by name or handle and get the wallet addresses that belong to them, plus userId and PnL. The cheap first step for any named person. Returns wallet addresses, userId and PnL — the cheap first step for any named person. Also finds tokens by ticker or name. For an arbitrary wallet address you already have, use stalkchain_wallet_pnl. Search by handle or display name (traders) or symbol/name (tokens). 250 credits. Trader hits already include userId, both wallets and PnL, so this is the CHEAP way to look a trader up (vs stalkchain_fomo_resolve_trader at 2,500). Token hits give address, name, networkId, and the LIVE market cap (circulating where known, with fdvUsd, priceUsd and liquidityUsd alongside; marketCapBasis says circulating or fully diluted, marketCapSource where each figure came from). Searching by userId is not supported - use stalkchain_fomo_resolve_trader for that.
Search traders and tokens › Request Body optional
qHandle, display name, token symbol or token name
typeRestrict result type (default all)
limitSearch traders and tokens › Responses
{ data, notes?, credits, meta }
Resolve trader (full live profile) - 2,500 credits
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
freshBypass the cache (costs credits again)
Bypass the cache (costs credits again)
Resolve trader (full live profile) - 2,500 credits › Responses
{ data, notes?, credits, meta }
Resolve trader (full live profile) - 2,500 credits
The complete live profile for one trader, when search is not enough. START WITH stalkchain_fomo_search (250 credits) — it already returns wallets, userId and PnL. Only come here when you need the full record. ~35 live fields: real Solana + EVM wallets, pnl {24h,7d,30d,all}, volume, trades, swapCount, followers/following, holdings count, topTokens, verified, description, clan, createdAt + accountAgeDays, averageHoldTimeSeconds, private/restricted flags. EXPENSIVE: 2,500 credits on a hit (250 on an unknown handle). If you only need wallets/userId/PnL, call stalkchain_fomo_search first (250). Result is cached 15 min. wallets.status="resolving" means try again shortly.
Resolve trader (full live profile) - 2,500 credits › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
freshBypass the cache (costs credits again)
Resolve trader (full live profile) - 2,500 credits › Responses
{ data, notes?, credits, meta }
Trader positions (open/closed, entry/exit, PnL)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
statusNarrow to open or closed. Traders with 200+ open positions hide all closed rows unless status=closed.
Narrow to open or closed. Traders with 200+ open positions hide all closed rows unless status=closed.
limitRows per page (max 200)
Rows per page (max 200)
cursor'start' for page 1, then the previous response's nextCursor
'start' for page 1, then the previous response's nextCursor
deeptrue = full fan-out (~12 upstream calls); N (2-12) = buy only N upstream calls
true = full fan-out (~12 upstream calls); N (2-12) = buy only N upstream calls
Trader positions (open/closed, entry/exit, PnL) › Responses
{ data, notes?, credits, meta }
Trader positions (open/closed, entry/exit, PnL)
What positions does this trader hold, and what did they enter and exit at. One row per token position: status, amount, avgEntryPrice/avgExitPrice, realized/unrealized PnL, costBasisUsd, bought/sold/transferredIn/Out amounts, priceUsd, chain, createdAt/closedAt, tradeId. 250 credits per upstream call. Upstream returns all OPEN positions but only 25 most-recent CLOSED per call: use status=closed for closed history, cursor='start' then nextCursor to page, or deep=true to fan out across chains/orders in one call (up to ~12 calls = 3,000 credits; deep=N buys N calls). A full history is never obtainable from the provider (complete is always false; closedTotalUpstream tells the real total). avgEntryPrice null = tokens were received, not bought. available:false = not captured yet. Heavy accounts often time out on the plain read; the server then automatically retries with deep=2 (per-chain fetch, same 250 credits) and marks the result [fallback: deep=2].
Trader positions (open/closed, entry/exit, PnL) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
statusNarrow to open or closed. Traders with 200+ open positions hide all closed rows unless status=closed.
limitRows per page (max 200)
cursor'start' for page 1, then the previous response's nextCursor
true = full fan-out (~12 upstream calls); N (2-12) = buy only N upstream calls
Trader positions (open/closed, entry/exit, PnL) › Responses
{ data, notes?, credits, meta }
Trader fills (individual swaps)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitcursornextCursor from the previous page
nextCursor from the previous page
tokenAddressScope to one token contract (reaches further back)
Scope to one token contract (reaches further back)
deepAccumulate more fills across chain/token filters
Accumulate more fills across chain/token filters
source'relay' = on-chain source across all chains
'relay' = on-chain source across all chains
Trader fills (individual swaps) › Responses
{ data, notes?, credits, meta }
Trader fills (individual swaps)
Every individual buy and sell this trader made, fill by fill. Answers 'every fill he has done', 'his trade history', 'all his swaps'. Use for the raw swap history rather than aggregated positions (for those use stalkchain_fomo_trader_positions). 100 per page, newest first: swapId, chain, tokenIn/tokenOut {address, amount, usd}, tradeIdIn/tradeIdOut (join to positions), at. 250 credits per page; page with cursor=nextCursor. The 100 cap is per FILTER: pass tokenAddress to reach months back for one token. deep=true re-asks per chain/token and accumulates across calls (moreAvailable/filtersRemaining say if another call helps). source='relay' reads the on-chain bridge instead (every chain in one query, usd at trade time AND usdNow, needs the trader resolved first; 409 retryable while resolving; keep calling while moreAvailable).
Trader fills (individual swaps) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitcursornextCursor from the previous page
tokenAddressScope to one token contract (reaches further back)
deepAccumulate more fills across chain/token filters
source'relay' = on-chain source across all chains
Trader fills (individual swaps) › Responses
{ data, notes?, credits, meta }
Tracked trader's live portfolio by handle (all chains)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
chainNarrow to one chain
Narrow to one chain
limitMax holdings rows returned (sorted by valueUsd desc)
Max holdings rows returned (sorted by valueUsd desc)
Tracked trader's live portfolio by handle (all chains) › Responses
{ data, notes?, credits, meta }
Tracked trader's live portfolio by handle (all chains)
What is this tracked trader holding in their wallet right now, looked up by FOMO handle or userId. Answers 'what is in his bags', 'current holdings', 'what does he hold now'. For a raw wallet address, or anyone the platform does not track, use stalkchain_wallet_portfolio instead. Live portfolio and current bags across Robinhood Chain, Solana, Ethereum, Base, BSC, Monad in ONE call: token {symbol,address,networkId}, chain, amount, priceUsd, valueUsd, change24h; plus totalValueUsd, byChain rollup, and livePerpPnl / hyperliquidPerps when present. 250 credits. Use chain= to narrow. Use for portfolio concentration and 'what are they holding right now'.
Tracked trader's live portfolio by handle (all chains) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
chainNarrow to one chain
limitMax holdings rows returned (sorted by valueUsd desc)
Tracked trader's live portfolio by handle (all chains) › Responses
{ data, notes?, credits, meta }
Who a trader follows (discovery)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitWho a trader follows (discovery) › Responses
{ data, notes?, credits, meta }
Who a trader follows (discovery)
Which accounts does this trader follow — the OUTBOUND direction, who they watch. For their own follower count use stalkchain_fomo_trader_followers. Useful for discovering traders you had no other way to find. Each account they watch, each annotated with followers, trades, volumeUsd, pnl24h, twitter, verified, accountAgeDays. 250 credits flat. Upstream caps at 200 names (truncated/sourceCapped flag it); partial+retryable=true means call again to resume. No wallets here - resolve a handle separately. Great for finding traders you had no other way to discover.
Who a trader follows (discovery) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitWho a trader follows (discovery) › Responses
{ data, notes?, credits, meta }
Who follows a trader (sample of 200)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitWho follows a trader (sample of 200) › Responses
{ data, notes?, credits, meta }
Who follows a trader (sample of 200)
How many people follow this trader, and who are they — the follower count and audience quality. This is the INBOUND direction; for the accounts they follow instead, use stalkchain_fomo_trader_following. A sample of the follower list, same per-person shape as following. Upstream serves at most 200 followers with no cursor, so this is a SAMPLE (sourceCapped=true), useful to judge the quality of a trader's backing, not to enumerate it. 250 credits flat.
Who follows a trader (sample of 200) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
limitWho follows a trader (sample of 200) › Responses
{ data, notes?, credits, meta }
Trader's best trades and best theses (FOMO's pick)
query Parameters
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader's best trades and best theses (FOMO's pick) › Responses
{ data, notes?, credits, meta }
Trader's best trades and best theses (FOMO's pick)
This trader's best ever trades and best written calls, as picked by the platform. The fastest way to judge someone you just came across. bestTrades[] and bestTheses[]: token, chain, entry/exit, cost basis, realized/unrealized PnL, openedAt/closedAt, the written thesis and its likes, tradeId. 250 credits. Fastest way to judge a trader you just found.
Trader's best trades and best theses (FOMO's pick) › Request Body optional
traderTrader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.
Trader's best trades and best theses (FOMO's pick) › Responses
{ data, notes?, credits, meta }
Research a trader before following them
query Parameters
traderHandle or userId
Handle or userId
fullUse the full live profile (~35 fields, 2,500 credits) instead of search (250)
Use the full live profile (~35 fields, 2,500 credits) instead of search (250)
includeThesesAdd the trader's most-liked theses (+1,250)
Add the trader's most-liked theses (+1,250)
closedSampleClosed positions to sample (default 100)
Closed positions to sample (default 100)
Research a trader before following them › Responses
{ data, notes?, credits, meta }
Research a trader before following them
Should I follow or copy this trader. START HERE for any question about whether a trader is worth trusting, copying or following — it replaces four separate calls. One-call due diligence: identity + wallets + PnL windows (cheap via search when you pass a HANDLE; a userId cannot be searched and forces the 2,500-credit live profile, so prefer the handle from the leaderboard row), or full live profile with full=true at 2,500 credits), the provider's spotlight (best trades/theses), live portfolio (total value, top holdings, concentration), and a sample of closed positions (win rate, realized PnL, best/worst). Optional most-liked theses (+1,250). ~1,000 credits with full=false. Every metric states its sample size; missing data is null, never 0.
Research a trader before following them › Request Body optional
traderHandle or userId
fullUse the full live profile (~35 fields, 2,500 credits) instead of search (250)
includeThesesAdd the trader's most-liked theses (+1,250)
closedSampleClosed positions to sample (default 100)
Research a trader before following them › Responses
{ data, notes?, credits, meta }
Compare 2-4 traders on comparable metrics
Side-by-side of PnL (per window when available), volume, trade count, followers, account age, verified flag and wallets. Uses search (250 each) by default; full=true uses the live profile (2,500 each) which adds pnl per window, swapCount, averageHoldTimeSeconds. Fields the provider did not return are null - never treat null as 0.
Compare 2-4 traders on comparable metrics › Request Body optional
tradersfullCompare 2-4 traders on comparable metrics › Responses
{ data, notes?, credits, meta }