# GMGN New Pair Scraper (`muhammetakkurtt/gmgn-new-pair-scraper`) Actor Track new crypto tokens across multiple blockchains with GMGN New Pair Scraper. This Apify tool extracts real-time data from GMGN.ai, providing key metrics on liquidity, market value, and risk factors for Ethereum, BSC, Solana, Base and Tron networks. Ideal for early opportunity detection. - **URL**: https://apify.com/muhammetakkurtt/gmgn-new-pair-scraper.md - **Developed by:** [Muhammet Akkurt](https://apify.com/muhammetakkurtt) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 206 total users, 4 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![GMGN New Pair Scraper](https://i.postimg.cc/0NFQ8H74/gmgn-banner.png) ## GMGN New Pair Scraper GMGN New Pair Scraper is a powerful web scraping tool developed for the Apify platform. This tool automatically extracts, analyzes, and allows you to monitor newly created token pairs on the [GMGN.ai](https://gmgn.ai/) platform. Operating across different blockchain networks (Ethereum, BSC, Base, Solana, Tron, Monad, HyperEVM, and MegaETH), it collects comprehensive information about new tokens, including transaction counts, liquidity, market value, and performance indicators. ### Why Use GMGN New Pair Scraper? GMGN New Pair Scraper saves you hours by automating manual data collection processes and provides access to the most up-to-date new token pairs. This tool offers you the following advantages: - **Time Saving**: Saves hours by automating manual data collection processes - **Comprehensive Data**: Complete dataset including transaction counts, liquidity information, and risk metrics - **Multi-Blockchain Support**: Works on Ethereum, BSC, Base, Solana, Tron, Monad, HyperEVM, and MegaETH networks - **Customizable Data Collection**: Ability to collect new token data at different time periods ### Features - Comprehensively extracts new token pairs from GMGN.ai - Can extract token data with various filters (liquidity, market value, holder count, transaction count, etc.) - **Platform Filtering**: Optionally filter by specific DEX/launchpad platforms on any network (leave empty to include all platforms). - Can retrieve token statistics according to different time periods (1 minute, 5 minutes, 1 hour, 6 hours, 24 hours) - Stores collected data in the Apify data repository and provides the ability to export in various formats (JSON, CSV, Excel) - Offers faster and more reliable results with proxy support - Ability to select data types ("New Pool", "Burnt", "Distributed", "DEXScreener Spent") ### Use Cases - **New Token Tracking**: Monitor newly launched tokens in the crypto market - **Early Discovery**: Early detection of rapidly popularizing new tokens - **Risk Assessment**: Risk assessment of token profiles and creating investment strategies - **Market Research**: Researching the performance of crypto assets across different blockchains - **Data Science Projects**: Creating comprehensive statistical datasets for crypto markets ### Usage 1. Run this actor in the Apify console. 2. Provide the necessary inputs: - **chain**: Blockchain network to scan (eth, bsc, base, sol, tron, monad, hyperevm, megaeth) - **timeRange**: Statistical time period (1m, 5m, 1h, 6h, 24h) - **dataType**: Data type (new\_pools, burnts, distribeds, dexscreener\_spents) - **limit**: Result limit - **filters**: Token filters (has\_social, not\_honeypot, verified, renounced, frozen, locked, distribed, creator\_hold, creator\_close, token\_burnt) - **DEX/Launchpad Platform filter (per network)**: each network has its own dropdown — `solanaPlatforms`, `ethPlatforms`, `bscPlatforms`, `basePlatforms`, `tronPlatforms`, `monadPlatforms`, `hyperevmPlatforms`, `megaethPlatforms`. Only the selected chain's list applies; leave empty to include all platforms. - **min/max metric filters**: liquidity (quote\_usd), marketcap, volume, holder\_count, sniper\_count, swaps1h, swaps, visiting\_count, created, rug\_ratio, total\_fee, bundler\_rate, entrapment\_ratio, insider\_rate - **proxyConfiguration**: Proxy configuration #### Example Input ```json { "chain": "sol", "timeRange": "1h", "dataType": "new_pools", "limit": 50, "solanaPlatforms": ["Pump.fun", "meteora_virtual_curve"], "filters": ["not_honeypot"], "min_marketcap": 10000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } } ``` ### Output The collected data is saved to the Apify dataset. The output data includes the following fields: - `id`: Token ID - Unique identifier for the token pair - `address`: Pool address - Contract address of the liquidity pool - `base_address`: Base token address - Contract address of the token - `quote_address`: Quote token address - Contract address of the paired token (often SOL, ETH, etc.) - `creation_timestamp`: Creation timestamp - Unix timestamp when the pool was created - `pool_type`: Pool type - Numeric identifier for the pool type - `pool_type_str`: Pool type string - Text representation of the pool type (pump, raydium, etc.) - `quote_symbol`: Quote symbol - Symbol of the paired token (SOL, ETH, etc.) - `burn_ratio`: Burn ratio - Percentage of tokens burned - `burn_status`: Burn status - Status of token burning (unknown, burn, etc.) - `open_timestamp`: Opening time - Unix timestamp when trading opened - `launchpad`: Launchpad - Platform where the token was launched - `liquidity`: Liquidity - Total liquidity value in USD - `quote_reserve`: Quote reserve - Amount of quote tokens in the pool - `initial_liquidity`: Initial liquidity - Initial liquidity amount when pool was created - `initial_quote_reserve`: Initial quote reserve - Initial amount of quote tokens when pool was created - `quote_reserve_usd`: Quote reserve USD - USD value of quote tokens in the pool - `bot_degen_count`: Bot degen count - Number of bot transactions detected - `base_token_info`: Token information object that includes: - `name`: Token name - `address`: Token contract address - `symbol`: Token symbol - `logo`: URL to the token logo - `total_supply`: Total supply of the token - `price`: Current price in USD - `holder_count`: Number of token holders - `launchpad_status`: Status on the launchpad - `price_change_percent1m`: 1-minute price change percentage - `price_change_percent5m`: 5-minute price change percentage - `price_change_percent1h`: 1-hour price change percentage - `burn_ratio`: Token burn ratio - `burn_status`: Status of token burning - `is_show_alert`: Whether there's an alert for this token - `hot_level`: Popularity level (0-3) - `liquidity`: Token liquidity in USD - `top_10_holder_rate`: Percentage owned by top 10 holders - `renounced_mint`: Minting capability renounced status - `renounced_freeze_account`: Freeze account capability renounced status - `creator_token_status`: Developer token status - `creator_close`: Developer close status - `creator_balance_rate`: Percentage of tokens held by creator - `rug_ratio`: Rug pull risk ratio - `market_cap`: Market capitalization in USD - `is_wash_trading`: Whether wash trading is detected - `volume`: Trading volume in USD - `swaps`: Number of swap transactions - `buys`: Number of buy transactions - `sells`: Number of sell transactions - `buy_tax`: Buy tax percentage (if any) - `sell_tax`: Sell tax percentage (if any) - `is_honeypot`: Whether token is identified as a honeypot - `rat_trader_amount_rate`: Novice trader amount ratio - `bluechip_owner_percentage`: Percentage owned by blue chip wallets - `smart_degen_count`: Number of smart degens - `renowned_count`: Number of renowned individuals - `base_token_info.social_links`: Social media links including: - `twitter_username`: Twitter username - `website`: Website URL - `telegram`: Telegram group link ### Example Output ```json { "id": 9148285, "address": "6sFeRJ1QQqLaB2D9cLic3uUinL8zcfshGzj3HyM77aey", "base_address": "FbN5jSbcY2WoXaiaSE14BbyP5czacr7Q5VnQunEMpump", "quote_address": "So11111111111111111111111111111111111111112", "quote_reserve": "1.001232", "initial_liquidity": "3.5839", "initial_quote_reserve": "0.01512", "pool_type_str": "pump", "pool_type": 1, "quote_symbol": "SOL", "base_token_info": { "symbol": "MM", "name": "Market Manipulation", "logo": "https://pump.mypinata.cloud/ipfs/Qmb7onxPwRaEm9VTzKPHLjMPCqQ7F2QEhVW4cnqiGwEuEv", "total_supply": 1000000000, "price": "0.000003565", "holder_count": 2, "launchpad_status": 0, "price_change_percent1m": "4.09281", "price_change_percent5m": "4.09281", "price_change_percent1h": "4.09281", "burn_ratio": "1.0000", "burn_status": "burn", "is_show_alert": true, "hot_level": 0, "liquidity": "237.4922", "top_10_holder_rate": 0.0402762, "renounced_mint": 1, "renounced_freeze_account": 1, "social_links": { "twitter_username": "DeItaone/status/1909253537944461750", "website": "", "telegram": "" }, "rug_ratio": null, "sniper_count": 2, "smart_degen_count": 0, "renowned_count": 0, "market_cap": "3565.203", "is_wash_trading": false, "creator_balance_rate": "0.03461", "creator_token_status": "creator_hold", "rat_trader_amount_rate": 0, "bluechip_owner_percentage": 0, "volume": "158.8944", "swaps": 3, "buys": 2, "sells": 1, "buy_tax": null, "sell_tax": null, "is_honeypot": null, "renounced": null, "dev_token_burn_amount": null, "dev_token_burn_ratio": null, "dexscr_ad": 0, "dexscr_update_link": 0, "cto_flag": 0, "twitter_change_flag": 0, "address": "FbN5jSbcY2WoXaiaSE14BbyP5czacr7Q5VnQunEMpump" }, "open_timestamp": 1744221264, "launchpad": "Pump.fun", "bot_degen_count": "0" } ``` This example output shows statistical data for a single token pair. The actual output will be a list of similar objects for all processed tokens. ### Notes - The collected data is stored in Apify's default data store. # Actor input Schema ## `chain` (type: `string`): Blockchain network to scan ## `timeRange` (type: `string`): Time period for new pair data ## `dataType` (type: `string`): Type of data to retrieve ## `limit` (type: `integer`): Maximum number of new pairs to retrieve ## `solanaPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = Solana. Leave empty to include all platforms. ## `ethPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = Ethereum. Leave empty to include all platforms. ## `bscPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = BSC. Leave empty to include all platforms. ## `basePlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = Base. Leave empty to include all platforms. ## `tronPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = Tron. Leave empty to include all platforms. ## `monadPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = Monad. Leave empty to include all platforms. ## `hyperevmPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = HyperEVM. Leave empty to include all platforms. ## `megaethPlatforms` (type: `array`): Filter by launchpad/DEX platform. Applies only when chain = MegaETH. Leave empty to include all platforms. ## `filters` (type: `array`): Token filters to apply (select multiple) ## `min_quote_usd` (type: `integer`): Minimum liquidity value in USD. ## `max_quote_usd` (type: `integer`): Maximum liquidity value in USD. ## `min_marketcap` (type: `integer`): Minimum market capitalization in USD. ## `max_marketcap` (type: `integer`): Maximum market capitalization in USD. ## `min_sniper_count` (type: `integer`): Minimum number of snipers ## `max_sniper_count` (type: `integer`): Maximum number of snipers ## `min_volume` (type: `integer`): Minimum trading volume in USD. ## `max_volume` (type: `integer`): Maximum trading volume in USD. ## `min_swaps1h` (type: `integer`): Minimum number of swaps in 1 hour ## `max_swaps1h` (type: `integer`): Maximum number of swaps in 1 hour ## `min_holder_count` (type: `integer`): Minimum number of token holders ## `max_holder_count` (type: `integer`): Maximum number of token holders ## `min_created` (type: `integer`): Minimum token age in minutes ## `max_created` (type: `integer`): Maximum token age in minutes ## `min_rug_ratio` (type: `integer`): Minimum rug ratio (value will be divided by 100) ## `max_rug_ratio` (type: `integer`): Maximum rug ratio (value will be divided by 100) ## `min_swaps` (type: `integer`): Minimum total number of swaps ## `max_swaps` (type: `integer`): Maximum total number of swaps ## `min_visiting_count` (type: `integer`): Minimum number of visits ## `max_visiting_count` (type: `integer`): Maximum number of visits ## `min_total_fee` (type: `integer`): Minimum total fee in USD. ## `max_total_fee` (type: `integer`): Maximum total fee in USD. ## `min_bundler_rate` (type: `integer`): Minimum bundler rate (value will be divided by 100) ## `max_bundler_rate` (type: `integer`): Maximum bundler rate (value will be divided by 100) ## `min_entrapment_ratio` (type: `integer`): Minimum entrapment ratio (value will be divided by 100) ## `max_entrapment_ratio` (type: `integer`): Maximum entrapment ratio (value will be divided by 100) ## `min_insider_rate` (type: `integer`): Minimum insider rate (value will be divided by 100) ## `max_insider_rate` (type: `integer`): Maximum insider rate (value will be divided by 100) ## `proxyConfiguration` (type: `object`): Using a proxy is recommended for faster and more reliable results ## Actor input object example ```json { "chain": "sol", "timeRange": "1h", "dataType": "new_pools", "limit": 50, "solanaPlatforms": [], "ethPlatforms": [], "bscPlatforms": [], "basePlatforms": [], "tronPlatforms": [], "monadPlatforms": [], "hyperevmPlatforms": [], "megaethPlatforms": [], "filters": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("muhammetakkurtt/gmgn-new-pair-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("muhammetakkurtt/gmgn-new-pair-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call muhammetakkurtt/gmgn-new-pair-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammetakkurtt/gmgn-new-pair-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/R14Lam2gdVcOltBS6/builds/8gFLUrkpyyeiSM02K/openapi.json