StalkChain Data
StalkChain Data API

Search traders and tokens

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_search

Search traders and tokens › query Parameters

q
​string · minLength: 1 · required

Handle, display name, token symbol or token name

Handle, display name, token symbol or token name

type
​string · enum

Restrict result type (default all)

Restrict result type (default all)

Enum values:
traders
tokens
all
limit
​integer · min: 1 · max: 100

Search traders and tokens › Responses

200

{ data, notes?, credits, meta }

No data returned

Search traders and tokens

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_search

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

q
​string · minLength: 1 · required

Handle, display name, token symbol or token name

type
​string · enum

Restrict result type (default all)

Enum values:
traders
tokens
all
limit
​integer · min: 1 · max: 100

Search traders and tokens › Responses

{ data, notes?, credits, meta }

No data returned

Resolve trader (full live profile) - 2,500 credits

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_resolve_trader

Resolve trader (full live profile) - 2,500 credits › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

fresh
​boolean

Bypass the cache (costs credits again)

Bypass the cache (costs credits again)

Resolve trader (full live profile) - 2,500 credits › Responses

200

{ data, notes?, credits, meta }

No data returned

Resolve trader (full live profile) - 2,500 credits

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_resolve_trader

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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

fresh
​boolean

Bypass the cache (costs credits again)

Resolve trader (full live profile) - 2,500 credits › Responses

{ data, notes?, credits, meta }

No data returned

Trader positions (open/closed, entry/exit, PnL)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_positions

Trader positions (open/closed, entry/exit, PnL) › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

status
​string · enum

Narrow 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.

Enum values:
open
closed
all
limit
​integer · min: 1 · max: 200

Rows per page (max 200)

Rows per page (max 200)

cursor
​string

'start' for page 1, then the previous response's nextCursor

'start' for page 1, then the previous response's nextCursor

deep
​

true = 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

200

{ data, notes?, credits, meta }

No data returned

Trader positions (open/closed, entry/exit, PnL)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_positions

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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

status
​string · enum

Narrow to open or closed. Traders with 200+ open positions hide all closed rows unless status=closed.

Enum values:
open
closed
all
limit
​integer · min: 1 · max: 200

Rows per page (max 200)

cursor
​string

'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 }

No data returned

Trader fills (individual swaps)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_swaps

Trader fills (individual swaps) › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

limit
​integer · min: 1 · max: 100
cursor
​string

nextCursor from the previous page

nextCursor from the previous page

tokenAddress
​string

Scope to one token contract (reaches further back)

Scope to one token contract (reaches further back)

deep
​boolean

Accumulate more fills across chain/token filters

Accumulate more fills across chain/token filters

source
​string · enum

'relay' = on-chain source across all chains

'relay' = on-chain source across all chains

Enum values:
relay

Trader fills (individual swaps) › Responses

200

{ data, notes?, credits, meta }

No data returned

Trader fills (individual swaps)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

limit
​integer · min: 1 · max: 100
cursor
​string

nextCursor from the previous page

tokenAddress
​string

Scope to one token contract (reaches further back)

deep
​boolean

Accumulate more fills across chain/token filters

source
​string · enum

'relay' = on-chain source across all chains

Enum values:
relay

Trader fills (individual swaps) › Responses

{ data, notes?, credits, meta }

No data returned

Tracked trader's live portfolio by handle (all chains)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_balances

Tracked trader's live portfolio by handle (all chains) › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

chain
​string · enum

Narrow to one chain

Narrow to one chain

Enum values:
robinhood
solana
base
bsc
eth
monad
hyperliquid
limit
​integer · min: 1 · max: 200

Max 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

200

{ data, notes?, credits, meta }

No data returned

Tracked trader's live portfolio by handle (all chains)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_balances

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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

chain
​string · enum

Narrow to one chain

Enum values:
robinhood
solana
base
bsc
eth
monad
hyperliquid
limit
​integer · min: 1 · max: 200

Max holdings rows returned (sorted by valueUsd desc)

Tracked trader's live portfolio by handle (all chains) › Responses

{ data, notes?, credits, meta }

No data returned

Who a trader follows (discovery)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_following

Who a trader follows (discovery) › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

limit
​integer · min: 1 · max: 300

Who a trader follows (discovery) › Responses

200

{ data, notes?, credits, meta }

No data returned

Who a trader follows (discovery)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_following

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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

limit
​integer · min: 1 · max: 300

Who a trader follows (discovery) › Responses

{ data, notes?, credits, meta }

No data returned

Who follows a trader (sample of 200)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_followers

Who follows a trader (sample of 200) › query Parameters

trader
​string · minLength: 1 · required

Trader 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.

limit
​integer · min: 1 · max: 200

Who follows a trader (sample of 200) › Responses

200

{ data, notes?, credits, meta }

No data returned

Who follows a trader (sample of 200)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_followers

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

trader
​string · minLength: 1 · required

Trader handle (case-insensitive, optional @) or userId (UUID). Prefer userId when known: handles can be renamed.

limit
​integer · min: 1 · max: 200

Who follows a trader (sample of 200) › Responses

{ data, notes?, credits, meta }

No data returned

Trader's best trades and best theses (FOMO's pick)

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_spotlight

Trader's best trades and best theses (FOMO's pick) › query Parameters

trader
​string · minLength: 1 · required

Trader 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

200

{ data, notes?, credits, meta }

No data returned

Trader's best trades and best theses (FOMO's pick)

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_spotlight

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

trader
​string · minLength: 1 · required

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 }

No data returned

Research a trader before following them

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_report

Research a trader before following them › query Parameters

trader
​string · minLength: 1 · required

Handle or userId

Handle or userId

full
​boolean

Use 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)

includeTheses
​boolean

Add the trader's most-liked theses (+1,250)

Add the trader's most-liked theses (+1,250)

closedSample
​integer · min: 10 · max: 200

Closed positions to sample (default 100)

Closed positions to sample (default 100)

Research a trader before following them › Responses

200

{ data, notes?, credits, meta }

No data returned

Research a trader before following them

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_trader_report

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

trader
​string · minLength: 1 · required

Handle or userId

full
​boolean

Use the full live profile (~35 fields, 2,500 credits) instead of search (250)

includeTheses
​boolean

Add the trader's most-liked theses (+1,250)

closedSample
​integer · min: 10 · max: 200

Closed positions to sample (default 100)

Research a trader before following them › Responses

{ data, notes?, credits, meta }

No data returned

Compare 2-4 traders on comparable metrics

GET
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_compare_traders

Compare 2-4 traders on comparable metrics › query Parameters

traders
​string[] · minItems: 2 · maxItems: 4 · required
full
​boolean

Compare 2-4 traders on comparable metrics › Responses

200

{ data, notes?, credits, meta }

No data returned

Compare 2-4 traders on comparable metrics

POST
https://data.stalkchain.com
/api/v1/tools/stalkchain_fomo_compare_traders

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

traders
​string[] · minItems: 2 · maxItems: 4 · required
full
​boolean

Compare 2-4 traders on comparable metrics › Responses

{ data, notes?, credits, meta }

No data returned