# GMGN Token Top Traders Scraper (`muhammetakkurtt/gmgn-token-traders-scraper`) Actor

Scrape the top 100 token traders for any token address on Ethereum, Solana, BSC, Base, and Tron. Analyze top trader strategies, track P\&L, and monitor buy/sell volumes in real-time. A must-have crypto intelligence tool for investors seeking an edge with deep on-chain data.

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

## Pricing

from $2.00 / 1,000 wallet data 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

![GMGN Token Top Traders API](https://i.postimg.cc/0NFQ8H74/gmgn-banner.png)

## GMGN Token Top Traders Scraper

GMGN Token Top Traders Scraper is a powerful web scraping tool developed for the Apify platform. This tool automatically extracts and analyzes data about wallets that trade specific cryptocurrencies on the [GMGN.ai](https://gmgn.ai/) platform. Operating across different blockchain networks (Ethereum, BSC, Base, Solana, Tron, Monad, HyperEVM, MegaETH, Robinhood, X Layer), this tool collects information about token traders including their balances, transaction volumes, profits/losses, and more.

### Why Should You Use GMGN Token Top Traders Scraper?

GMGN Token Top Traders Scraper saves you hours by automating manual data collection processes and provides you with access to the most up-to-date token trader data. This tool offers you the following advantages:

- **Time Saving**: Saves you hours by automating manual data collection processes
- **Comprehensive Data**: Complete data set including trader balances, transaction volumes, profit/loss metrics
- **Multi-Blockchain Support**: Works on Ethereum, BSC, Base, Solana, Tron, Monad, HyperEVM, MegaETH, Robinhood and X Layer networks
- **Customizable Data Collection**: Ability to sort and filter traders according to your needs
- **Trader Classification**: Filter token traders by tags (Smart, KOL/VC, DEV, Snipers, Renames, etc.)

### Features

- Extracts token trader information from GMGN.ai
- **Retrieves the top 100 token traders** for each token address
- Can filter token traders based on various criteria and tags
- Can scrape traders data for multiple token addresses at once
- Sorts token traders by different metrics (Realized PNL, Unrealized PNL, Bought/Sold Volume, PNL)
- Stores collected data in Apify data storage and allows you to export it in various formats (JSON, CSV, Excel)

### Use Cases

- **Token Trader Analysis**: Analyze trading patterns and behavior of wallets for specific tokens
- **Investor Tracking**: Identify major traders and their trading patterns
- **Market Research**: Track trader behavior and trade volumes over time
- **Data Science Projects**: Create comprehensive datasets about token traders for research
- **Profitability Analysis**: Compare realized and unrealized profits across different trader categories

### Ready-to-Run Examples

Get started in seconds — open an example in the Apify Console and click **Run**:

- **[Solana Bundle Checker: Find Bundler Wallets in a Token](https://apify.com/muhammetakkurtt/gmgn-token-traders-scraper/examples/check-solana-token-for-bundler-wallets)** — check a Solana token for bundled wallets: each bundler's share of supply, USD value, buys, sells, PnL and tags, sorted by ownership, as JSON, CSV or Excel.
- **[Find Insider Wallets in a Solana Token](https://apify.com/muhammetakkurtt/gmgn-token-traders-scraper/examples/find-insider-wallets-in-solana-token)** — find insider wallets in any Solana token: each insider's share of supply, USD value, buys, sells, PnL and tags, sorted by ownership, as JSON, CSV or Excel.

### Usage

1. Run this actor in the Apify console.
2. Provide the necessary inputs:
   - **tokenAddresses**: Token addresses to scan (you can enter multiple addresses)
   - **chain**: Blockchain network to scan (eth, bsc, base, sol, tron, monad, hyperevm, megaeth, robinhood, xlayer)
   - **tag**: Filter token traders by tag (smart_wallets, kol_vc, developers, snipers, renames etc.)
   - **sortBy**: Criterion for sorting results (ownership_percentage, bought_volume, sold_volume, profit_loss, last_activity)
   - Results are automatically sorted in descending order (highest to lowest)
   - **proxyConfiguration**: Proxy setup

#### Example Input

```json
{
  "tokenAddresses": ["AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump"],
  "chain": "sol",
  "tag": "all_holders",
  "sortBy": "ownership_percentage",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
```

### Output

The collected data is saved to the Apify dataset. For each token, the scraper retrieves the **top 100 traders** based on your sorting criteria. The output data structure includes the following fields:

#### Core Wallet Information

- `address`: Wallet address of the token trader
- `account_address`: Related account address
- `addr_type`: Address type identifier
- `name`: Wallet name (if available)
- `avatar`: Avatar URL (if available)
- `twitter_username`: Associated Twitter username (if available)
- `twitter_name`: Twitter display name (if available)
- `created_at`: Timestamp when the wallet was created
- `is_new`: Boolean indicating if this is a new wallet
- `is_suspicious`: Boolean indicating if the wallet is flagged as suspicious
- `is_on_curve`: Boolean indicating if the address is on curve
- `transfer_in`: Boolean indicating if tokens were transferred in

#### Token Holdings

- `balance`: Current token balance
- `native_balance`: Native blockchain currency balance
- `amount_cur`: Current token amount held
- `amount_percentage`: Percentage ownership of the token's total supply
- `accu_amount`: Accumulated amount of tokens

#### Financial Metrics

- `usd_value`: USD value of the holdings
- `cost_cur`: Current cost basis in currency
- `cost`: Cost basis
- `total_cost`: Total cost including all transactions
- `accu_cost`: Accumulated cost
- `profit`: Overall profit/loss
- `profit_change`: Recent change in profit
- `realized_profit`: Realized profit from sold tokens
- `realized_pnl`: Realized profit and loss ratio
- `unrealized_profit`: Unrealized profit on current holdings
- `unrealized_pnl`: Unrealized profit and loss ratio

#### Trading Activity

- `avg_cost`: Average cost basis per token
- `avg_sold`: Average price per token when sold
- `buy_volume_cur`: Total buy volume in currency
- `sell_volume_cur`: Total sell volume in currency
- `buy_amount_cur`: Total amount of tokens bought
- `sell_amount_cur`: Total amount of tokens sold
- `sell_amount_percentage`: Percentage of acquired tokens that were sold
- `buy_tx_count_cur`: Number of buy transactions
- `sell_tx_count_cur`: Number of sell transactions
- `current_buy_amount`: Current buy amount
- `current_sell_amount`: Current sell amount
- `current_transfer_in_amount`: Current transfer in amount
- `current_transfer_out_amount`: Current transfer out amount
- `netflow_usd`: Net flow of funds in USD
- `netflow_amount`: Net flow of token amount
- `start_holding_at`: Timestamp when the wallet started holding this token
- `end_holding_at`: Timestamp when the wallet fully exited this position (null if still holding)
- `last_active_timestamp`: Timestamp of the last transaction
- `last_block`: Last block number of activity

#### Historical Data

- `history_bought_cost`: Historical cost of bought tokens
- `history_bought_fee`: Historical fees paid for buying
- `history_sold_income`: Historical income from selling
- `history_sold_fee`: Historical fees paid for selling
- `history_transfer_in_cost`: Historical cost of transfer ins
- `history_transfer_out_income`: Historical income from transfer outs
- `history_transfer_out_fee`: Historical fees for transfer outs
- `transfer_in_count`: Number of transfer in transactions
- `transfer_out_count`: Number of transfer out transactions

#### Classification and Tags

- `wallet_tag_v2`: Wallet classification tag (e.g., "TOP3")
- `tags`: Array of tags associated with the wallet
- `maker_token_tags`: Array of maker token tags (e.g., "bundler", "top_holder")

#### Transfer Information

- `native_transfer`: Object containing information about native currency transfers
  - `name`: Name of the transfer (if available)
  - `from_address`: Address that sent the native currency
  - `amount`: Amount of native currency transferred
  - `timestamp`: Timestamp of the transfer
  - `tx_hash`: Transaction hash
- `token_transfer`: Object containing information about token transfers
  - `name`: Name of the transfer
  - `address`: Address involved in the transfer
  - `timestamp`: Timestamp of the transfer
  - `tx_hash`: Transaction hash
  - `type`: Type of transfer (e.g., "buy")
- `token_transfer_in`: Object containing information about token transfer ins
  - `name`: Name of the transfer
  - `address`: Address involved in the transfer
  - `timestamp`: Timestamp of the transfer
  - `tx_hash`: Transaction hash
  - `type`: Type of transfer
- `token_transfer_out`: Object containing information about token transfer outs
  - `name`: Name of the transfer
  - `address`: Address involved in the transfer
  - `timestamp`: Timestamp of the transfer
  - `tx_hash`: Transaction hash
  - `type`: Type of transfer

#### Token Information

- `token_address`: Address of the token being analyzed
- `chain`: Blockchain network (e.g., "sol", "eth", "bsc")

### Example Output

```json
{
  "address": "6ZRKesFWaihxCCxDydrdMVUEsRBJ6SRfJWLaNz6t8zyb",
  "account_address": "59X49Ma8U2LhsuzugktZzTivVWhBxj6BoH5SRCqh2ABz",
  "addr_type": 0,
  "native_balance": "115569261",
  "balance": 0,
  "amount_cur": 0,
  "usd_value": 0,
  "amount_percentage": 0,
  "accu_amount": 0,
  "accu_cost": 0,
  "cost": 0,
  "cost_cur": 0,
  "sell_amount_cur": 2277.098742,
  "sell_amount_percentage": 1,
  "sell_volume_cur": 2.0287688292,
  "buy_volume_cur": 1.2326,
  "buy_amount_cur": 2277.098742,
  "netflow_usd": -0.7961688292000002,
  "netflow_amount": 0,
  "buy_tx_count_cur": 1,
  "sell_tx_count_cur": 1,
  "current_buy_amount": 2277.098742,
  "current_sell_amount": 2277.098742,
  "current_transfer_in_amount": 0,
  "current_transfer_out_amount": 0,
  "history_bought_cost": 1.2326,
  "history_bought_fee": 0.20906202556,
  "history_sold_income": 2.0287688292,
  "history_sold_fee": 0.1440835713,
  "history_transfer_in_cost": 0,
  "history_transfer_out_income": 0,
  "history_transfer_out_fee": 0,
  "transfer_in_count": 0,
  "transfer_out_count": 0,
  "wallet_tag_v2": "TOP1",
  "profit": 0.44302323234,
  "total_cost": 1.5857455968599998,
  "profit_change": 0.2793785038515942,
  "realized_profit": 0.44302323234,
  "realized_pnl": 0.2793785038515942,
  "unrealized_profit": 0,
  "unrealized_pnl": null,
  "avg_cost": 0.0005413028329713073,
  "avg_sold": 0.000890944600592116,
  "transfer_in": false,
  "is_new": false,
  "is_suspicious": false,
  "is_on_curve": true,
  "start_holding_at": 1766848011,
  "end_holding_at": 1766848248,
  "last_block": 389531428,
  "last_active_timestamp": 1766848248,
  "native_transfer": {
      "name": null,
      "from_address": "D1ancgooBGaa2Fc4ZEU5V7MEeeU7VSmiCrsuuJtKczRJ",
      "amount": "0.051712",
      "timestamp": 1760405362,
      "tx_hash": "5aW1gP2ES7j6T2zY54vJQXia1eEcevEvqN6eikDd7XWjLP53qHpvQUbn18LYP5aw9zwMAf2GW6vGwoFrc5LNf73N"
  },
  "token_transfer": {
      "name": null,
      "address": "",
      "timestamp": 0,
      "tx_hash": "",
      "type": "buy"
  },
  "token_transfer_in": {
      "name": null,
      "address": "",
      "timestamp": 0,
      "tx_hash": "",
      "type": "buy"
  },
  "token_transfer_out": {
      "name": null,
      "address": "",
      "timestamp": 0,
      "tx_hash": "",
      "type": "sell"
  },
  "tags": [
      "gmgn"
  ],
  "maker_token_tags": [
      "paper_hands"
  ],
  "name": null,
  "avatar": null,
  "twitter_username": null,
  "twitter_name": null,
  "created_at": 1760405605,
  "token_address": "AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump",
  "chain": "sol"
}
```

This example output shows the structured data of a single token trader. The actual output will be a list of similar objects for all token holders of the specified tokens.

### Notes

- The collected data is stored in Apify's default data store.
- The scraper retrieves a maximum of 100 token traders per token address, sorted according to your specified criteria.

# Actor input Schema

## `tokenAddresses` (type: `array`):

Token addresses to scan (you can enter multiple addresses)

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

Blockchain network to scan

## `tag` (type: `string`):

Filter token holders by tag (select 'All Holders' to show all holders)

## `sortBy` (type: `string`):

Criteria for sorting token traders

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

Using a proxy is recommended for faster and more reliable results

## Actor input object example

```json
{
  "tokenAddresses": [
    "AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump"
  ],
  "chain": "sol",
  "tag": "all_holders",
  "sortBy": "profit_loss",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
```

# Actor output Schema

## `tokenTraders` (type: `string`):

List of top 100 traders for each token address, including wallet information, financial metrics, trading activity, and classification tags.

# 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 = {
    "tokenAddresses": [
        "AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammetakkurtt/gmgn-token-traders-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 = { "tokenAddresses": ["AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump"] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,muhammetakkurtt/gmgn-token-traders-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/3WDM2QYge1jVRQgEF/builds/GoFGdrcZIVXr4j3lU/openapi.json
