GMGN Trending Tokens Actor

GMGN trending tokens from GMGN API across multiple blockchain chains.

Supported Chains

• Solana (sol) - Default chain
• Ethereum (eth)
• Base (base)
• Binance Smart Chain (bsc)
• Tron (tron)

Input Configuration

Required Parameters

chain

• Type: String
• Description: The blockchain chain to fetch trending tokens from
• Options: sol (Solana), eth (Ethereum), base (Base), bsc (Binance Smart Chain), tron (Tron)
• Default: sol

time

• Type: String
• Description: Time window for trending analysis
• Options: 1m (1 Minute), 5m (5 Minutes), 1h (1 Hour), 6h (6 Hours), 24h (24 Hours)
• Default: 1h

Optional Parameters

orderby

• Type: String
• Description: Field to order results by
• Options: volume (Volume), market_cap (Market Cap), price_change_percent (Price Change %), swaps (Swaps), liquidity (Liquidity), holder_count (Holder Count), created_timestamp (Created Time)
• Default: volume

direction

• Type: String
• Description: Sort direction for results
• Options: asc (Ascending), desc (Descending)
• Default: desc

Holders min_holder_count

• Type: String
• Description: Minimum number of token holders
• Format: Numeric string (e.g., "100", "1000")
• Pattern: Numbers only

Holders max_holder_count

• Type: String
• Description: Maximum number of token holders
• Format: Numeric string (e.g., "5000", "10000")
• Pattern: Numbers only

MC min_marketcap

• Type: String
• Description: Minimum market capitalization in USD
• Format: Supports units K/M/B (e.g., "10K", "1M", "1B")
• Pattern: Number with optional decimal and unit suffix

MC max_marketcap

• Type: String
• Description: Maximum market capitalization in USD
• Format: Supports units K/M/B (e.g., "100M", "5B")
• Pattern: Number with optional decimal and unit suffix

Age min_created

• Type: String
• Description: Minimum creation time (token age)
• Format: Supports minutes/hour/day (e.g., "1m", "2h", "3d")
• Pattern: Number followed by m/h/d

Age max_created

• Type: String
• Description: Maximum creation time (token age)
• Format: Supports minutes/hour/day (e.g., "24h", "7d")
• Pattern: Number followed by m/h/d

Liq min_liquidity

• Type: String
• Description: Minimum liquidity in USD
• Format: Supports units K/M/B (e.g., "50K", "1M")
• Pattern: Number with optional decimal and unit suffix

Liq max_liquidity

• Type: String
• Description: Maximum liquidity in USD
• Format: Supports units K/M/B (e.g., "10M", "100M")
• Pattern: Number with optional decimal and unit suffix

Txs min_swaps

• Type: String
• Description: Minimum number of swaps/transactions
• Format: Supports units K/M/B (e.g., "100", "1K", "10K")
• Pattern: Number with optional decimal and unit suffix

Txs max_swaps

• Type: String
• Description: Maximum number of swaps/transactions
• Format: Supports units K/M/B (e.g., "50K", "100K")
• Pattern: Number with optional decimal and unit suffix

Vol min_volume

• Type: String
• Description: Minimum trading volume in USD
• Format: Supports units K/M/B (e.g., "10K", "100K", "1M")
• Pattern: Number with optional decimal and unit suffix

Vol max_volume

• Type: String
• Description: Maximum trading volume in USD
• Format: Supports units K/M/B (e.g., "50M", "500M")
• Pattern: Number with optional decimal and unit suffix

filters

• Type: Array of Strings

• Description: Select filtering criteria for tokens. Available filters depend on the selected blockchain

• Default: Empty array []

• Filters for Solana (sol)

  UI Keyword	Filter Value	Description
  Renounced	renounced	Contract ownership has been renounced
  Burnt	burnt	Liquidity pool tokens have been burnt
  Top10	top10	Filter by top 10 token holders
  Blacklist	blacklist	Exclude tokens that are blacklisted
  Not Migrated Only	not_migrated_only	Only include tokens that have not been migrated
  Filter Wash Traded	filter_wash_traded	Exclude tokens with wash trading activity
  Filter Risks	filter_risks	Exclude tokens flagged as risky

• Filters for EVM Chains (eth, base, bsc, tron)

  UI Keyword	Filter Value	Description
  Renounced	renounced	Contract ownership has been renounced
  Not Honeypot	not_honeypot	Exclude tokens identified as honeypots
  Verified	verified	Only include tokens with verified contracts
  Locked	locked	Only include tokens with locked liquidity
  Filter Honeypot	filter_honeypot	Exclude potential honeypot tokens

platforms

• Type: Array of Strings

• Description: Select specific platforms to filter by. Available platforms depend on the selected blockchain

• Default: Empty array []

• Options: See detailed platform options below

• Platforms for Solana (sol)

  UI Keyword	Platform Value	Description
  Pumpfun	Pump.fun	Pump.fun platform for meme token launches
  Bonk	letsbonk	Bonk-themed token platform
  Moonshot	moonshot_app	Moonshot token launch application
  Bags	bags	Bags token trading platform
  Believe	believe	Believe token platform
  Studio	jup_studio	Jupiter Studio ecosystem platform
  GFM	gofundmeme	Go Fund Meme fundraising platform
  Boop	boop	Boop token platform
  Dynamic BC	meteora_virtual_curve	Dynamic bonding curve via Meteora
  Launchlab	ray_launchpad	Raydium Launch Lab platform
  Moonit	Moonshot	Moonit token launch platform
  xStocks	xstocks	xStocks trading platform
  Pump AMM	pool_pump_amm	Pump AMM liquidity pools
  Raydium	pool_ray	Raydium DEX liquidity pools
  Meteora	pool_meteora	Meteora protocol liquidity pools
  Orca	pool_orca	Orca DEX liquidity pools

• Platforms for BSC (bsc)

  UI Keyword	Platform Value	Description
  PanCake	pancake	PancakeSwap DEX for BSC token trading
  FourMeme	fourmeme	4meme BSC meme token platform
  Uniswap	uniswap	Uniswap DEX on BSC network

Usage Examples

Basic Usage

{
  "chain": "sol",
  "time": "1h"
}

Advanced Filtering

{
  "chain": "sol",
  "time": "24h",
  "orderby": "market_cap",
  "direction": "desc",
  "min_marketcap": "1M",
  "max_marketcap": "100M",
  "min_holder_count": "100",
  "min_created": "1m",
  "max_created": "10d",
  "min_liquidity": "10k",
  "max_liquidity": "100M",
  "min_swaps":"1k",
  "min_voluume":"1k",
  "filters": ["renounced", "burnt"],
  "platforms": ["Pump.fun", "pool_ray"]
}

Ethereum Tokens with Safety Filters

{
  "chain": "eth",
  "time": "6h",
  "orderby": "volume",
  "min_liquidity": "50K",
  "filters": ["verified", "not_honeypot", "locked"]
}

Output

The collected data is saved to the Apify dataset. The actor returns trending token data in JSON format with the following structure:

{
  "id": 12345,                           // Unique token identifier
  "chain": "sol",                        // Blockchain network (sol, eth, base, bsc, tron)
  "address": "token_contract_address",   // Token contract address
  "symbol": "TOKEN",                     // Token symbol/ticker
  "logo": "https://example.com/logo.png", // Token logo image URL
  "price": 0.123456,                     // Current token price in USD
  "price_change_percent": 15.67,         // Overall price change percentage
  "price_change_percent1m": 2.34,        // Price change in last 1 minute
  "price_change_percent5m": 5.12,        // Price change in last 5 minutes
  "price_change_percent1h": 8.90,        // Price change in last 1 hour
  "swaps": 1234,                         // Total number of swap transactions
  "buys": 890,                           // Number of buy orders
  "sells": 344,                          // Number of sell orders
  "volume": 567890.12,                   // Trading volume in USD
  "liquidity": 123456.78,                // Current liquidity in USD
  "market_cap": 9876543.21,              // Market capitalization in USD
  "total_supply": 1000000000,            // Total token supply
  "holder_count": 2500,                  // Number of token holders
  "hot_level": 85,                       // Trending/hotness level indicator
  "pool_creation_timestamp": 1692123456, // Unix timestamp of pool creation
  "open_timestamp": 1692123456,          // Unix timestamp when trading opened
  "pool_type": 1,                        // Pool type identifier (numeric)
  "pool_type_str": "Raydium",            // Pool type name (e.g., Raydium, Uniswap)
  "twitter_username": "@tokenproject",   // Associated Twitter handle
  "website": "https://tokenproject.com", // Official website URL
  "telegram": "https://t.me/tokenproject", // Telegram group/channel URL
  "initial_liquidity": 50000.0,          // Initial liquidity amount
  "is_show_alert": false,                // Whether to show risk alert
  "top_10_holder_rate": 0.456,           // Percentage held by top 10 holders
  "renounced_mint": 1,                   // Mint authority renounced (1=yes, 0=no)
  "renounced_freeze_account": 1,         // Freeze authority renounced (1=yes, 0=no)
  "burn_ratio": "0.15",                  // Token burn ratio (percentage)
  "burn_status": "burned",               // Current burn status
  "dev_token_burn_amount": 150000000,    // Amount of tokens burned by developer
  "dev_token_burn_ratio": 0.15,          // Ratio of tokens burned by developer
  "creator": "creator_wallet_address",   // Token creator's wallet address
  "creator_close": false,                // Whether creator closed their position
  "launchpad_status": 2,                 // Status on launchpad platform
  "is_og": true,                         // Whether this is an OG (original) token
  "is_wash_trading": false,              // Whether wash trading is detected
  "rug_ratio": 0.05,                     // Rug pull risk ratio (0-1, lower is safer)
  "bluechip_owner_percentage": 0.23,     // Percentage of bluechip token owners
  "sniper_count": 12,                    // Number of sniper bot accounts
  "smart_degen_count": 45,               // Number of smart degen traders
  "renowned_count": 8                    // Number of KOL traders
}

Notes

• Different chains support different filtering options and platforms
• Use appropriate units (K/M/B) for numerical values where supported
• Time filters support m (minutes), h (hours), d (days) format