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 platform. Operating across different blockchain networks (Ethereum, BSC, Base, Solana, Tron), 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, and Tron 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

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

{
  "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

{
  "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.