# FOMO Token Holders Scraper (`muhammetakkurtt/fomo-token-holders-scraper`) Actor

Find which FOMO (fomo.family) traders hold any crypto token — top holders with position size, average entry price, cost basis, realized and unrealized PnL, hold time and their thesis notes. Solana and EVM tokens. Export as JSON, CSV or Excel.

- **URL**: https://apify.com/muhammetakkurtt/fomo-token-holders-scraper.md
- **Developed by:** [Muhammet Akkurt](https://apify.com/muhammetakkurtt) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.00 / 1,000 token holder scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Token Holders Scraper — which fomo.family traders hold a crypto token, with entry price, PnL and thesis](https://i.postimg.cc/P5yx9Qpg/fomo-banner.png)

## FOMO Token Holders Scraper

**Find out which FOMO (fomo.family) traders hold any crypto token — and how they're doing on it.** Enter a token address and get its top FOMO holders with position size and value, average entry price, cost basis, realized and unrealized PnL, how long they've held, and the thesis notes they wrote — as structured data.

No coding needed. Paste token addresses, click **Start**, and download as JSON, CSV, Excel, XML, HTML or RSS.

### What is FOMO (fomo.family)?

FOMO is a social crypto copy-trading app where traders publish their on-chain trades, holdings and theses. The **FOMO Token Holders Scraper** shows the smart money behind any token — which FOMO traders hold it, at what entry, and with what profit or loss.

### What data does it extract?

Each holder of each token is one item:

| Section | Fields |
|---|---|
| **Token** | Token address, chain (network id), total holder count |
| **Rank** | The holder's position among the token's top FOMO holders, by position value |
| **Position** | Token amount, current price, position value (USD) |
| **Performance** | Average entry price, cost basis, total PnL, realized and unrealized PnL |
| **Behavior** | Average hold time, and whether the holder is the token's developer |
| **Thesis** | The holder's note on the position, with likes and the price and market cap when it was written |
| **Trader** | Handle, display name, Solana & EVM wallet address, followers, trade count, total volume, verified, clan, badge |

### Why scrape FOMO token holders?

- 🧠 **Smart-money research** — see which active traders hold a token before you buy
- 📊 **Entry and PnL analysis** — compare holders' average entries and profits with the current price
- 🧾 **Holder theses** — read why traders hold a token, in their own words
- 🛠️ **Developer tracking** — check whether a token's developer still holds it
- 🤖 **Automation** — run it via the [Apify API](https://docs.apify.com/api/v2), on a [schedule](https://docs.apify.com/platform/schedules), with [webhooks](https://docs.apify.com/platform/integrations/webhooks)

### How to use it (step by step)

1. Open the [FOMO Token Holders Scraper](https://apify.com/muhammetakkurtt/fomo-token-holders-scraper) on Apify Store and click **Try for free**
2. Enter one or more **Token Addresses** — Solana or EVM (0x) addresses, one per line
3. Optionally set **Max Holders per Token** and **Include Developer Holding**
4. Click **Start**, then export as **JSON**, **CSV**, **Excel**, **XML**, **HTML**, or **RSS**

#### Example input

```json
{
  "tokens": ["Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"],
  "maxHolders": 100,
  "includeDev": true
}
```

#### Input parameters

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `tokens` | Array | ✅ Yes | — | Token addresses, one per line. Solana and EVM (0x) addresses; the chain is detected automatically. |
| `maxHolders` | Integer | No | `100` | Top FOMO holders to return per token (up to 100). |
| `includeDev` | Boolean | No | `true` | Also return the developer's holding when the developer is not among the top holders. |

### Output example

> The output is the raw structure returned by FOMO (fields as-is; some are nested).

```json
{
  "tokenAddress": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk",
  "networkId": 1399811149,
  "totalHolders": 15900,
  "rank": 1,
  "user": {
    "id": "36adb85a-c0fd-5fa8-916d-8fdc32fe4237",
    "userHandle": "unipcs",
    "displayName": "Unipcs",
    "address": "FJDy9FDRy6bwGEUKuAC98bUtN8MkpE2pT7Dj7HE3Z7Q1",
    "followers": 734208,
    "numTrades": 6321,
    "clan": { "name": "Fantom Troupe" }
  },
  "humanAmount": 15899792.06,
  "price": 0.2929,
  "value": 4657568.71,
  "averageEntryPrice": 0.0536,
  "costBasis": 886626.6,
  "pnl": 3820286.96,
  "unrealizedPnl": 3804867.02,
  "realizedPnl": 15419.94,
  "averageHoldTimeSeconds": 349647,
  "isDev": false,
  "comment": {
    "comment": "$USELESS now live on Arcus 👀",
    "numLikes": 104,
    "priceUsdAtCreation": 0.301,
    "marketCapAtCreation": 301014958.64,
    "createdAt": "2026-09-25T12:42:00.856Z"
  }
}
```

### Frequently asked questions

#### Which blockchains are supported?

Solana and the EVM chains FOMO supports, such as Base, BNB Chain and Robinhood Chain. Just paste the token address — the chain is detected automatically.

#### How many holders are returned per token?

Up to the top 100 FOMO holders per token, ranked by position value. Use `maxHolders` to return fewer.

#### What is the developer holding?

If the token's developer holds it but isn't among the returned top holders, their holding is added as an extra item (`rank` is empty and `isDev` is `true`). Turn it off with `includeDev`.

#### What are "thesis notes"?

Many FOMO traders attach a written thesis to their position explaining why they hold the token — the scraper returns it with its likes and the price and market cap at the time it was written.

#### What if a token has no FOMO holders?

It is skipped and noted in the run log, and nothing is charged for it.

#### How do I get support?

Open an issue on the [Issues tab](https://apify.com/muhammetakkurtt/fomo-token-holders-scraper/issues) of the actor page, or contact the developer for a custom scraping solution.

# Actor input Schema

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

Token addresses to look up — one per line. Solana and EVM (0x) addresses are supported; the chain is detected automatically.

## `maxHolders` (type: `integer`):

Number of top FOMO holders to return per token (up to 100).

## `includeDev` (type: `boolean`):

Also return the token developer's holding when the developer is not among the top holders.

## `proxyConfiguration` (type: `object`):

Proxy configuration (optional).

## Actor input object example

```json
{
  "tokens": [
    "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"
  ],
  "maxHolders": 100,
  "includeDev": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Collected FOMO token holders, one item per holder

# 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": [
        "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammetakkurtt/fomo-token-holders-scraper").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": ["Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"] }

# Run the Actor and wait for it to finish
run = client.actor("muhammetakkurtt/fomo-token-holders-scraper").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": [
    "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"
  ]
}' |
apify call muhammetakkurtt/fomo-token-holders-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,muhammetakkurtt/fomo-token-holders-scraper"
        }
    }
}
```

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/aDRIxrbf8q2F3S7DC/builds/ZhRIeQcxXHPftG0wo/openapi.json