GMGN Trending Data Actor

Fetches trending token data from the GMGN API across multiple blockchain networks. Use it to filter and sort tokens by metrics like volume, market cap, and holder count.

Overview

This actor retrieves a list of trending tokens for a specified blockchain and time window. You can filter results using various financial and on-chain metrics and control the sort order. It's useful for tracking market movements, identifying new tokens, or feeding data into other analysis tools.

Key Features

• Multi-Chain Support: Fetch data for Solana (default), Ethereum, Base, Binance Smart Chain, and Tron.
• Flexible Timeframes: Analyze trends over periods from 1 minute to 24 hours.
• Granular Filtering: Filter tokens by market cap, liquidity, volume, holder count, age, and number of swaps.
• Custom Sorting: Order results by key metrics in ascending or descending order.
• Chain-Specific Filters: Apply advanced filters like renounced (Solana) or verified_contract (EVM chains).

How to Use

Configure the actor with input parameters via the Apify console, API, or a scheduled run. The actor will output a dataset of trending tokens matching your criteria.

Input Configuration

Required Parameters

• chain (String): The blockchain to query.
  • Options: sol, eth, base, bsc, tron
  • Default: sol
• time (String): The time window for the trending analysis.
  • Options: 1m, 5m, 1h, 6h, 24h
  • Default: 1h

Optional Parameters

• orderby (String): The field to sort results by.
  • Options: volume, market_cap, price_change_percent, swaps, liquidity, holder_count, created_timestamp
  • Default: volume
• direction (String): Sort direction.
  • Options: asc, desc
  • Default: desc

Filter Parameters: All filter parameters are optional strings. Use numeric values with optional unit suffixes (K, M, B) for financial fields, or numbers followed by m/h/d for age.

• Holder Filters: min_holder_count, max_holder_count
• Market Cap Filters: min_marketcap, max_marketcap
• Age Filters: min_created, max_created
• Liquidity Filters: min_liquidity, max_liquidity
• Transaction Filters: min_swaps, max_swaps
• Volume Filters: min_volume, max_volume
• filters (String): Apply chain-specific advanced filters. Use comma-separated values (e.g., renounced,top_10_holder).
  • Solana (sol): renounced, top_10_holder, top_25_holder, top_50_holder
  • EVM Chains (eth, base, bsc): verified_contract, top_10_holder, top_25_holder, top_50_holder

Output

The actor outputs items to the dataset, each representing a trending token. Output fields typically include:

• symbol: Token ticker symbol.
• name: Full token name.
• address: Contract address.
• price: Current price in USD.
• price_change_percent: Price change over the selected time window.
• volume: Trading volume in USD.
• market_cap: Market capitalization in USD.
• liquidity: Pool liquidity in USD.
• holder_count: Number of token holders.
• created_timestamp: Token creation time.
• chain: Source blockchain.

Access results via the Apify dataset API or export them to formats like JSON, CSV, or Excel.