# FOMO Smart Money Token Data: Holders, Flow, Devs (`stlakchain/fomo-smart-money-token-data`) Actor

What smart money is doing on a token: which tracked traders and KOLs hold it and their share, buy and sell pressure, dev and insider positions, whether KOLs are dumping, written theses, candles, trending boards and one-call token analysis. Pick a dataset, give it token addresses.

- **URL**: https://apify.com/stlakchain/fomo-smart-money-token-data.md
- **Developed by:** [StalkChain](https://apify.com/stlakchain) (community)
- **Categories:** Social media, AI, Lead generation
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## FOMO Smart Money Token Data: Holders, Flow, Devs

What smart money is doing on a token: which tracked traders and KOLs hold it and their share, buy and sell pressure, dev and insider positions, whether KOLs are dumping, written theses, candles, trending boards and one-call token analysis. Pick a dataset, give it token addresses.

### What you can do with it

- Check whether smart money holds a coin before buying
- Catch KOLs dumping a token you hold
- Rug-check dev and insider positions
- Research trending tokens in one run

### Datasets

Choose one in the `dataset` field. Each is priced per row.

| `dataset` | What you get | Price per row |
| --- | --- | --- |
| `token-board` | **FOMO Trending, Most-Held & Graduated Tokens**. The token boards traders watch: trending now, most held, or just graduated from the bonding curve. Each row has rank, symbol, address, chain, holders, price, 24h change, market cap and volume. | $0.004 |
| `kol-holders` | **FOMO Smart Money Holders of Any Token**. Which tracked FOMO traders and KOLs hold a token right now, with amount, USD value, cost basis, PnL and their real Solana and EVM wallets. Use it to check whether smart money is in a coin before you buy. | $0.004 |
| `kol-holders-x` | **FOMO KOL Holder Count & Smart Money Share**. How many tracked traders hold a token and what share of all holders is smart money, with each holder's bag and the token's total holders and top-10 concentration. Use for 'is smart money in this ticker' as a number. | $0.003 |
| `kol-sell-pressure` | **KOL Sell Pressure: Is Smart Money Dumping?**. What share of a token's tracked holders sold or exited recently, who sold, and who still holds. Use it when the question is whether KOLs are dumping a coin. | $0.003 |
| `token-flow` | **Token Buy/Sell Pressure & Holder Concentration**. Buys vs sells for a token over 5m, 1h, 4h and 24h: counts, unique buyers and sellers, buy, sell and net USD volume, buy/sell ratio, plus total holders and top-10 concentration. Use it to see whether a coin is being accumulated or dumped. | $0.010 |
| `token-devs` | **Token Dev & Insider Holdings (Rug Signal)**. The deployer and insiders of a token with their own positions: amount, USD value, cost basis, PnL and average entry. A dev closing their bag shows here first. An empty result means no dev holding is known, not that the token is safe. | $0.008 |
| `theses` | **FOMO Trade Theses: What Traders Wrote on a Token**. The written calls on one token: every thesis traders posted, with author, text, likes, replies and whether the author is the dev. Sort by likes or recency. Use it to read the reasoning behind a coin, not just its price. | $0.004 |
| `analyze-token` | **Memecoin Analysis Report: Flow, Holders, Devs**. A one-row research report on a token: buy/sell flow, smart-money holders, dev and insider positions and top theses, combined. Use it for 'tell me about this coin' in a single call. | $0.030 |
| `top-traders-for-tokens` | **Top Traders Holding Several Tokens at Once**. Give up to five tokens and get the tracked traders holding them, ranked by how many of those tokens they hold and by leaderboard PnL, with wallets. Use it to find who is positioned in a narrative. | $0.003 |
| `token-launch-research` | **Who Launched This Token, and When**. Who launched a token and when, as far as the data shows: the deployer and insiders, their wallets and positions, when the dev opened their position, whether they sold, and the token's age. | $0.030 |
| `token-snapshot` | **Token Holder Snapshot for Change Tracking**. A compact snapshot of a token: price, total holders, top-10 concentration, tracked holders with their bags and 24h flow. Schedule it and compare runs to see how holders change over time. | $0.030 |
| `compare-snapshots` | **Compare Two Token Snapshots**. Diff two holder snapshots of a token (from the holder snapshot dataset): new and exited tracked holders, who added or trimmed, and the change in holders, concentration and price. Pass the two snapshots as `before` and `after`. | $0.030 |
| `token-candles` | **Token OHLCV Candles for Memecoins**. OHLCV price candles for a token from 1-second to 7-day resolution, for charting, backtests and technical analysis. Give it token addresses and a resolution. | $0.001 |
| `trending-analysis` | **Trending Memecoin Analysis: Top Tokens Researched**. Reads the trending, graduated or most-held board and runs a full analysis on the top tokens: flow, smart-money holders and devs for each. Use it to go find something worth buying. | $0.030 |

### Input

| Field | What it is |
| --- | --- |
| `tokens` | Token contract address (EVM 0x... or Solana mint). Add as many as you need; each token is looked up in turn. Used by: kol-holders, kol-holders-x, kol-sell-pressure, token-flow, token-devs, theses, analyze-token, top-traders-for-tokens, token-launch-research, t |
| `board` | Which board: trending, most-held or graduated. Used by: token-board, trending-analysis. |
| `limit` | How many rows to return per input. Lower is faster and cheaper. Used by: token-board, kol-holders, kol-holders-x, theses, top-traders-for-tokens. |
| `chain` | Chain name or networkId; only needed for tokens outside the provider's directory. Used by: kol-holders-x, kol-sell-pressure, token-flow, token-devs, analyze-token, token-launch-research, token-snapshot, token-candles, trending-analysis. |
| `includeStats` | Default true. Used by: kol-holders-x. |
| `windowMinutes` | Look-back (default 1440 = 24h). Coverage is bounded by the newest 100 sell alerts; the response states the range actually covered. Used by: kol-sell-pressure. |
| `thresholdPercent` | Alert threshold (default 10). Used by: kol-sell-pressure. |
| `sort` | Order of the results. Used by: theses. |
| `network` | Only theses on this network. Used by: theses. |
| `minLikes` | Only include theses with at least this many likes. Used by: theses. |
| `pages` | Default 1. Each extra page = +1,250 credits. Used by: theses. |
| `includeTheses` | Add most-liked theses (+1,250 credits). Used by: analyze-token, trending-analysis. |
| `includeDevs` | Default true. Used by: analyze-token. |
| `window` | Leaderboard window to rank by (default 7d). Used by: top-traders-for-tokens. |
| `holdersLimit` | Default 50. Used by: token-snapshot. |
| `before` | Before. Used by: compare-snapshots. |
| `after` | After. Used by: compare-snapshots. |
| `resolution` | e.g. 1, 5, 60, 1D, 15S. Used by: token-candles. |
| `countBack` | How many candles to return, counting back from now (or from `to`). Used by: token-candles. |
| `from` | Start of the range, as an ISO date or a Unix timestamp in seconds. Used by: token-candles. |
| `to` | End of the range, as an ISO date or a Unix timestamp in seconds. Used by: token-candles. |
| `fill` | Emit empty buckets too. Used by: token-candles. |
| `topN` | Default 3. Used by: trending-analysis. |
| `maxMarketCapUsd` | Skip tokens above this market cap (find early ones). Used by: trending-analysis. |
| `maxItems` | Stop after this many rows, whatever the inputs would produce. Caps the cost of a run. |

Examples:

```json
{
  "dataset": "token-board",
  "board": "trending",
  "limit": 25
}
```

```json
{
  "dataset": "kol-holders",
  "tokens": [
    "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
  ],
  "limit": 20
}
```

```json
{
  "dataset": "kol-holders-x",
  "tokens": [
    "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
  ],
  "limit": 20
}
```

### Output

One row per result, as a table you can export to JSON, CSV or Excel, or read from the API. Every row carries `scrapedAt`.

Columns by dataset:

- `token-board`: `board`, `rank`, `name`, `symbol`, `address`, `network`, `holders`, `priceUsd`, `change24h`, `marketCapUsd`, `volume24hUsd`
- `kol-holders`: `token`, `tokenSymbol`, `handle`, `displayName`, `solanaWallet`, `evmWallet`, `amount`, `valueUsd`, `costBasisUsd`, `pnlUsd`, `unrealizedPnlUsd`, `isDev`, `followers`
- `kol-holders-x`: `input`, `token`, `priceUsd`, `trackedHolderCount`, `trackedValueUsd`, `totalHolders`, `trackedShareOfHoldersPct`, `top10HoldersPercent`, `top5TrackedSharePctOfTrackedValue`, `handle`, `displayName`, `walletSolana`, `walletEvm`, `walletVerified`
- `kol-sell-pressure`: `input`, `token`, `windowMinutes`, `coveredFrom`, `currentTrackedHolders`, `sellersInWindow`, `fullyExitedSellers`, `trimmedButStillHolding`, `unmatchedSellers`, `denominator`, `sellersPct`, `thresholdPercent`, `thresholdCrossed`, `handle`
- `token-flow`: `token`, `window`, `buys`, `sells`, `uniqueBuyers`, `uniqueSellers`, `buyVolumeUsd`, `sellVolumeUsd`, `netVolumeUsd`, `buySellRatio`, `totalHolders`, `top10HoldersPercent`
- `token-devs`: `token`, `handle`, `role`, `amount`, `valueUsd`, `soldPercent`
- `theses`: `subject`, `subjectType`, `handle`, `userId`, `text`, `likes`, `replies`, `isDev`, `at`
- `analyze-token`: `input`, `token`, `chain`, `priceUsd`, `holders`, `top10HoldersPercent`, `flow5m`, `flow1h`, `flow4h`, `flow24h`, `trackedHolderCount`, `trackedValueUsd`, `topTrackedHolders`, `devs`
- `top-traders-for-tokens`: `window`, `tradersFound`, `handle`, `tokensHeldCount`, `totalValueUsd`, `leaderboardRank`, `leaderboardPnlUsd`, `userId`, `walletsSolana`, `walletsEvm`, `walletsVerified`, `walletsNote`, `verified`, `wallets`
- `token-launch-research`: `input`, `token`, `chain`, `deployer`, `launchTimeEstimate`, `insiders`, `note`
- `token-snapshot`: `input`, `token`, `capturedAt`, `priceUsd`, `totalHolders`, `top10HoldersPercent`, `trackedHolderCount`, `trackedHolders`, `flow24hBuys`, `flow24hSells`, `flow24hUniqueBuyers`, `flow24hUniqueSellers`, `flow24hBuyVolumeUsd`, `flow24hSellVolumeUsd`
- `token-candles`: `token`, `time`, `unixTime`, `open`, `high`, `low`, `close`, `volume`
- `trending-analysis`: `board`, `boardSource`, `capturedAt`, `candidates`, `boardRank`, `boardSymbol`, `boardName`, `boardNetwork`, `boardPriceUsd`, `boardChange24h`, `boardMarketCapUsd`, `boardVolume24hUsd`, `boardHolders`, `token`

A missing value is `null`, never `0`: null means the data was not captured, which is worth telling apart from a real zero. If one input fails, the others still arrive, and the failures are listed in the run's `RUN_SUMMARY` record.

### Pricing

Pay per result, at the price per row shown for each dataset above, plus $0.001 per run. `maxItems` caps what one run can spend.

### Use it from an AI agent

This Actor is a tool in [Apify's MCP server](https://mcp.apify.com/?actors=stlakchain/fomo-smart-money-token-data), so Claude, ChatGPT, Cursor or any MCP client can call it directly. The same data is also served interactively, with every tool in one place, by the StalkChain MCP server at [data.stalkchain.com](https://data.stalkchain.com).

### Schedule it

Much of this data is live and not kept by the source. A scheduled run (every 10 minutes, hourly, daily) builds a history you can chart and diff, with `scrapedAt` on every row.

### More from StalkChain

- [FOMO Crypto Trader Intelligence: PnL & Wallets](https://apify.com/stlakchain/fomo-crypto-trader-intelligence)
- [FOMO Live Smart Money Signals & Trade Alerts](https://apify.com/stlakchain/fomo-live-smart-money-signals)
- [Solana On-chain: Token Risk, Snipers, Wallet PnL](https://apify.com/stlakchain/solana-token-wallet-onchain)
- [StonkFun Launchpad Data: Tokens, Burns, Rewards](https://apify.com/stlakchain/stonkfun-launchpad-data)
- [Multi-chain Crypto Wallets & Token Prices](https://apify.com/stlakchain/crypto-wallets-prices-multichain)
- [DeFi Data: Yields, Hacks, TVL & Protocols](https://apify.com/stlakchain/defi-yields-hacks-tvl)

# Actor input Schema

## `dataset` (type: `string`):

What to fetch. Each dataset uses the fields below marked for it; fields for other datasets are ignored.

## `tokens` (type: `array`):

Token contract address (EVM 0x... or Solana mint). Add as many as you need; each token is looked up in turn. Used by: kol-holders, kol-holders-x, kol-sell-pressure, token-flow, token-devs, theses, analyze-token, top-traders-for-tokens, token-launch-research, token-snapshot, token-candles.

## `board` (type: `string`):

Which board: trending, most-held or graduated. Used by: token-board, trending-analysis.

## `limit` (type: `integer`):

How many rows to return per input. Lower is faster and cheaper. Used by: token-board, kol-holders, kol-holders-x, theses, top-traders-for-tokens.

## `chain` (type: `string`):

Chain name or networkId; only needed for tokens outside the provider's directory. Used by: kol-holders-x, kol-sell-pressure, token-flow, token-devs, analyze-token, token-launch-research, token-snapshot, token-candles, trending-analysis.

## `includeStats` (type: `boolean`):

Default true. Used by: kol-holders-x.

## `windowMinutes` (type: `integer`):

Look-back (default 1440 = 24h). Coverage is bounded by the newest 100 sell alerts; the response states the range actually covered. Used by: kol-sell-pressure.

## `thresholdPercent` (type: `integer`):

Alert threshold (default 10). Used by: kol-sell-pressure.

## `sort` (type: `string`):

Order of the results. Used by: theses.

## `network` (type: `string`):

Only theses on this network. Used by: theses.

## `minLikes` (type: `integer`):

Only include theses with at least this many likes. Used by: theses.

## `pages` (type: `integer`):

Default 1. Each extra page = +1,250 credits. Used by: theses.

## `includeTheses` (type: `boolean`):

Add most-liked theses (+1,250 credits). Used by: analyze-token, trending-analysis.

## `includeDevs` (type: `boolean`):

Default true. Used by: analyze-token.

## `window` (type: `string`):

Leaderboard window to rank by (default 7d). Used by: top-traders-for-tokens.

## `holdersLimit` (type: `integer`):

Default 50. Used by: token-snapshot.

## `before` (type: `object`):

Before. Used by: compare-snapshots.

## `after` (type: `object`):

After. Used by: compare-snapshots.

## `resolution` (type: `string`):

e.g. 1, 5, 60, 1D, 15S. Used by: token-candles.

## `countBack` (type: `integer`):

How many candles to return, counting back from now (or from `to`). Used by: token-candles.

## `from` (type: `string`):

Start of the range, as an ISO date or a Unix timestamp in seconds. Used by: token-candles.

## `to` (type: `string`):

End of the range, as an ISO date or a Unix timestamp in seconds. Used by: token-candles.

## `fill` (type: `boolean`):

Emit empty buckets too. Used by: token-candles.

## `topN` (type: `integer`):

Default 3. Used by: trending-analysis.

## `maxMarketCapUsd` (type: `integer`):

Skip tokens above this market cap (find early ones). Used by: trending-analysis.

## `maxItems` (type: `integer`):

Stop after this many rows, whatever the inputs would produce. Caps the cost of a run.

## Actor input object example

```json
{
  "dataset": "token-board",
  "tokens": [
    "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
  ],
  "board": "trending",
  "limit": 25,
  "maxItems": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

Every row the run saved, one per item.

## `summary` (type: `string`):

Rows saved, whether the run stopped early, and failed lookups.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tokens": [
        "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
    ],
    "board": "trending",
    "limit": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("stlakchain/fomo-smart-money-token-data").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "tokens": ["9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"],
    "board": "trending",
    "limit": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("stlakchain/fomo-smart-money-token-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tokens": [
    "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
  ],
  "board": "trending",
  "limit": 25
}' |
apify call stlakchain/fomo-smart-money-token-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,stlakchain/fomo-smart-money-token-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Z1BGJ3NH6w2ngehgx/builds/22XH9P9MqbxaBhLd3/openapi.json