GMGN Token Holders Scraper

GMGN Token Holders Scraper is a powerful web scraping tool developed for the Apify platform. This tool automatically extracts and analyzes data about wallets that hold specific cryptocurrencies on the GMGN.ai platform. Operating across different blockchain networks (Ethereum, BSC, Base, Solana, Tron), this tool collects information about token holders including their balances, transaction volumes, profits/losses, and more.

Why Should You Use GMGN Token Holders Scraper?

GMGN Token Holders Scraper saves you hours by automating manual data collection processes and provides you with access to the most up-to-date token holder 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 holder balances, transaction volumes, profit/loss metrics
• Multi-Blockchain Support: Works on Ethereum, BSC, Base, Solana, and Tron networks
• Customizable Data Collection: Ability to sort and filter holders according to your needs
• Holder Classification: Filter token holders by tags (Smart, KOL/VC, DEV, etc.)

Features

• Extracts token holder information from GMGN.ai
• Retrieves the top 100 token holders for each token address
• Can filter token holders based on various criteria (last activity, profit/loss, ownership percentage)
• Can scrape holders data for multiple token addresses at once
• Sorts token holders by different metrics (ownership percentage, buy/sell volumes, PNL, activity)
• Stores collected data in Apify data storage and allows you to export it in various formats (JSON, CSV, Excel)

Use Cases

• Token Distribution Analysis: Analyze how your token is distributed among different holders
• Investor Analysis: Identify major holders and their trading patterns
• Market Research: Track holder behavior and ownership changes over time
• Data Science Projects: Create comprehensive datasets about token holders for research
• Competition Analysis: Compare holder distributions across competing tokens

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)
   • tag: Filter token holders by tag (smart_wallets, kol_vc, developers, etc.)
   • sortBy: Criterion for sorting results (ownership_percentage, bought_volume, sold_volume, etc.)
   • sortDirection: Sort direction (asc, desc)
   • proxyConfiguration: Proxy setup

Example Input

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

Output

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

Core Wallet Information

• address: Wallet address of the token holder
• 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
• 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
• 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
• 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

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
  • timestamp: Timestamp of the transfer
• 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 Information

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

Example Output

{
  "address": "4nUf9FP9Y4GyN65xYqBwk2ajrrMM6bpswEbXLxjQ67zm",
  "account_address": "ETphEHjJxXLfNNBonjgcymbRTnMSRJNQkvxXfkLUTyGm",
  "addr_type": 0,
  "amount_cur": 9239245.228824,
  "usd_value": 1205.083902048291,
  "cost_cur": 1201.2547902373244,
  "sell_amount_cur": 1503515111.084343,
  "sell_amount_percentage": 0.9938924352190652,
  "sell_volume_cur": 207363.14935526816,
  "buy_volume_cur": 208868.54510704946,
  "buy_amount_cur": 1513504613.354784,
  "netflow_usd": 1505.395751781296,
  "netflow_amount": 9989502.270441055,
  "buy_tx_count_cur": 322,
  "sell_tx_count_cur": 315,
  "wallet_tag_v2": "TOP3",
  "native_balance": "567076284",
  "balance": 9239245.228824,
  "profit": -202.76601748905586,
  "realized_profit": -206.5951293000225,
  "profit_change": -0.0009712365136603802,
  "amount_percentage": 0.009239248120708662,
  "unrealized_profit": 3.8291118109666513,
  "unrealized_pnl": 0.003187593374932688,
  "avg_cost": 0.0001380032431114157,
  "avg_sold": 0.0001379188994021595,
  "accu_amount": 9989502.270441,
  "accu_cost": 1298.8006224812875,
  "cost": 1201.2547902373244,
  "total_cost": 208770.9992748055,
  "transfer_in": false,
  "is_new": false,
  "is_suspicious": true,
  "start_holding_at": 1750866830,
  "end_holding_at": null,
  "last_active_timestamp": 1750871639,
  "native_transfer": {
    "name": null,
    "from_address": "6nTHiWMoha7zDRuQ7SV1iAHB1TPWpRRrfATLpkF56hWM",
    "timestamp": 1749216198
  },
  "token_transfer": {
    "name": "",
    "address": "",
    "timestamp": 0,
    "tx_hash": "",
    "type": "buy"
  },
  "tags": [],
  "maker_token_tags": [
    "bundler",
    "top_holder"
  ],
  "name": null,
  "avatar": null,
  "twitter_username": null,
  "twitter_name": null,
  "created_at": 1749221928,
  "token_address": "AubzP19mqmSy1wv2WXw4nM3wJEbUM2VightARuN7Pump",
  "chain": "sol"
}

This example output shows the structured data of a single token holder. 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 holders per token address, sorted according to your specified criteria.