GMGN Token Traders Scraper

# GMGN Token Traders Scraper GMGN Token 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 Traders Scraper? GMGN Token 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 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 - 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 json { "address": "Fy59pHLh4h6io99PV1XXwQKLNVbp1DFrHRCfP5yb8FC", "account_address": "9nykZZ87uowKyQjhc7qok7NQcpXqqZmo27zcfFTWR6MC", "addr_type": 0, "amount_cur": 0, "usd_value": 0, "cost_cur": 0, "sell_amount_cur": 383647.216711, "sell_amount_percentage": 1, "sell_volume_cur": 58.64990483387, "buy_volume_cur": 84.14609513698, "buy_amount_cur": 732656.939322, "netflow_usd": 25.49619030311, "netflow_amount": 349009.722611, "buy_tx_count_cur": 3, "sell_tx_count_cur": 5, "wallet_tag_v2": "TOP1", "native_balance": "210835280", "balance": 0, "profit": 20.4444832766185, "realized_profit": 20.4444832766185, "profit_change": 0.535119950083054, "amount_percentage": 0, "unrealized_profit": 0, "unrealized_pnl": null, "avg_cost": 0.000114850608273564, "avg_sold": 0.000152874574033599, "accu_amount": 349009.722611, "accu_cost": 45.9406735797285, "cost": 0, "total_cost": 38.2054215572515, "transfer_in": false, "is_new": false, "is_suspicious": true, "start_holding_at": 1750866889, "end_holding_at": 1750873182, "last_active_timestamp": 1750873195, "native_transfer": { "name": null, "from_address": "6nTHiWMoha7zDRuQ7SV1iAHB1TPWpRRrfATLpkF56hWM", "timestamp": 1749216199 }, "token_transfer": { "name": "", "address": "", "timestamp": 1.8446744011573955e+19, "tx_hash": "", "type": "transfer_in" }, "tags": [], "maker_token_tags": [ "bundler" ], "name": null, "avatar": null, "twitter_username": null, "twitter_name": null, "created_at": 1749216782, "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.