{ "openapi": "3.0.1", "info": { "title": "GMGN Scraper — Trending Memecoins, Smart Money & Wallets", "description": "GMGN.ai scraper & unofficial API: export trending memecoins, smart-money wallets and rugchecks to CSV/JSON. No login, no API key.", "version": "1.0", "x-build-id": "u5YDJcF2D2NdEfh4U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~gmgn-trending-memecoin-scanner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-gmgn-trending-memecoin-scanner", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/logiover~gmgn-trending-memecoin-scanner/runs": { "post": { "operationId": "runs-sync-logiover-gmgn-trending-memecoin-scanner", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/logiover~gmgn-trending-memecoin-scanner/run-sync": { "post": { "operationId": "run-sync-logiover-gmgn-trending-memecoin-scanner", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Data mode", "enum": [ "trending", "newPairs", "walletLeaderboard", "buySignals", "rugcheck", "tokenHolders", "walletPnl", "signalsFeed" ], "type": "string", "description": "Which GMGN dataset to pull. Each mode uses its own input fields (grouped below). 'trending' is the flagship multi-chain hot-token scanner.", "default": "trending" }, "chains": { "title": "Chains", "uniqueItems": true, "type": "array", "description": "[trending · newPairs · walletLeaderboard · buySignals] Blockchains to scan. Solana (sol) and BSC are the highest-volume memecoin chains.", "items": { "type": "string", "enum": [ "sol", "bsc", "eth", "base", "tron", "monad" ], "enumTitles": [ "Solana", "BSC (BNB Chain)", "Ethereum", "Base", "Tron", "Monad" ] }, "default": [ "sol", "bsc", "eth", "base", "tron", "monad" ] }, "timeframes": { "title": "Timeframes", "uniqueItems": true, "type": "array", "description": "[trending] Timeframes to scan. Shorter = freshest hot tokens; 24h = stable trending.", "items": { "type": "string", "enum": [ "1m", "5m", "1h", "24h" ], "enumTitles": [ "1 minute", "5 minutes", "1 hour", "24 hours" ] }, "default": [ "1m", "5m", "1h", "24h" ] }, "filters": { "title": "Security filters (trending)", "uniqueItems": true, "type": "array", "description": "[trending] GMGN security filters applied before ranking. Leave empty for the full unfiltered list.", "items": { "type": "string", "enum": [ "not_honeypot", "verified", "renounced", "frozen", "no_mint_authority", "burnt" ], "enumTitles": [ "Not Honeypot", "Verified", "Renounced Ownership", "Frozen Liquidity", "No Mint Authority", "LP Burnt" ] }, "default": [ "not_honeypot" ] }, "orderBy": { "title": "Order by (trending)", "enum": [ "", "volume", "market_cap", "swaps", "holder_count", "price_change_percent", "smart_degen_count", "liquidity" ], "type": "string", "description": "[trending] Sort tokens before truncation. Default = GMGN hot score.", "default": "" }, "direction": { "title": "Sort direction", "enum": [ "desc", "asc" ], "type": "string", "description": "[trending · newPairs · walletLeaderboard · tokenHolders · walletPnl] Sort direction.", "default": "desc" }, "maxResultsPerCall": { "title": "Max results per API call", "minimum": 10, "maximum": 100, "type": "integer", "description": "[trending · newPairs] Tokens per (chain, timeframe/period) request. Max 100 (GMGN limit).", "default": 100 }, "minVolumeUsd": { "title": "Min volume (USD)", "minimum": 0, "type": "integer", "description": "[trending · walletLeaderboard] Drop rows below this USD volume. 0 = no filter.", "default": 0 }, "minLiquidityUsd": { "title": "Min liquidity (USD)", "minimum": 0, "type": "integer", "description": "[trending · newPairs · buySignals] Drop tokens below this liquidity. 0 = no filter.", "default": 0 }, "minHolderCount": { "title": "Min holder count", "minimum": 0, "type": "integer", "description": "[trending · newPairs] Drop tokens with fewer holders. 0 = no filter.", "default": 0 }, "minSmartMoneyCount": { "title": "Min smart-money holders", "minimum": 0, "type": "integer", "description": "[trending] Drop tokens with fewer smart-money wallets holding. 0 = no filter.", "default": 0 }, "maxAgeHours": { "title": "Max token age (hours)", "minimum": 0, "type": "integer", "description": "[trending] Drop tokens older than N hours. 0 = no age filter.", "default": 0 }, "includeBinanceDex": { "title": "Include Binance DEX rank (BSC)", "type": "boolean", "description": "[trending] Also fetch the curated Binance DEX rank for BSC.", "default": true }, "deduplicate": { "title": "Deduplicate", "type": "boolean", "description": "[trending · newPairs · walletLeaderboard] Emit each token/wallet once with an array of which timeframes/periods/orderings surfaced it.", "default": false }, "newPairsPeriods": { "title": "Periods (new pairs)", "uniqueItems": true, "type": "array", "description": "[newPairs] Launch windows to scan.", "items": { "type": "string", "enum": [ "1h", "6h", "24h" ], "enumTitles": [ "1 hour", "6 hours", "24 hours" ] }, "default": [ "1h" ] }, "launchpads": { "title": "Launchpad filter", "type": "array", "description": "[newPairs] Keep only these launchpad platforms (e.g. pump.fun). Empty = all.", "default": [], "items": { "type": "string" } }, "newPairsFilters": { "title": "Security filters (new pairs)", "type": "array", "description": "[newPairs] GMGN filter flags applied to new pairs. Empty = unfiltered.", "default": [], "items": { "type": "string" } }, "newPairsOrderBy": { "title": "Order by (new pairs)", "enum": [ "open_timestamp", "volume", "market_cap", "holder_count", "liquidity", "swaps" ], "type": "string", "description": "[newPairs] Sort field for new pairs.", "default": "open_timestamp" }, "minMarketCapUsd": { "title": "Min market cap (USD)", "minimum": 0, "type": "integer", "description": "[newPairs · buySignals] Drop tokens below this market cap. 0 = no filter.", "default": 0 }, "onlyWithSocials": { "title": "Only tokens with socials", "type": "boolean", "description": "[newPairs] Keep only tokens with Twitter/Telegram/website.", "default": false }, "excludeHoneypots": { "title": "Exclude honeypots", "type": "boolean", "description": "[newPairs · buySignals] Drop honeypot (cannot-sell) tokens.", "default": true }, "walletPeriods": { "title": "Periods (leaderboard)", "uniqueItems": true, "type": "array", "description": "[walletLeaderboard] PnL windows to rank traders over.", "items": { "type": "string", "enum": [ "1d", "7d", "30d" ], "enumTitles": [ "1 day", "7 days", "30 days" ] }, "default": [ "1d", "7d" ] }, "orderByList": { "title": "Order by (one or more)", "type": "array", "description": "[walletLeaderboard] GMGN ranking metrics, e.g. pnl_7d, realized_profit_7d, winrate_7d.", "default": [ "pnl_7d", "realized_profit_7d" ], "items": { "type": "string" } }, "minPnl": { "title": "Min PnL", "type": "integer", "description": "[walletLeaderboard] Min PnL for the period. 0 = no filter.", "default": 0 }, "minRealizedProfitUsd": { "title": "Min realized profit (USD)", "type": "integer", "description": "[walletLeaderboard] 0 = no filter.", "default": 0 }, "minWinrate": { "title": "Min winrate (0-1)", "type": "number", "description": "[walletLeaderboard] e.g. 0.6 = 60%. 0 = no filter.", "default": 0 }, "minTxs": { "title": "Min transactions", "type": "integer", "description": "[walletLeaderboard] 0 = no filter.", "default": 0 }, "onlyWithTwitter": { "title": "Only wallets with Twitter", "type": "boolean", "description": "[walletLeaderboard] Keep only wallets with a linked Twitter.", "default": false }, "tagFilter": { "title": "Tag filter", "type": "array", "description": "[walletLeaderboard · buySignals · tokenHolders] Keep only rows matching these GMGN wallet tags (e.g. smart_money, whale, sniper). Empty = all.", "default": [], "items": { "type": "string" } }, "buySignalsFeed": { "title": "Feed", "enum": [ "cards", "trades", "both" ], "type": "string", "description": "[buySignals] Which smart-money feed to pull.", "default": "cards" }, "cardsPeriod": { "title": "Cards period", "enum": [ "1h", "24h" ], "type": "string", "description": "[buySignals] Lookback window for the aggregated cards feed.", "default": "24h" }, "tradesLimit": { "title": "Trades limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "[buySignals] Max live trades per chain.", "default": 100 }, "explodeWallets": { "title": "Explode wallets", "type": "boolean", "description": "[buySignals] Emit one row per smart wallet per card instead of one row per card.", "default": false }, "minSmartWallets": { "title": "Min smart wallets", "type": "integer", "description": "[buySignals] Drop cards with fewer smart wallets. 0 = no filter.", "default": 0 }, "onlyNewBuys": { "title": "Only new buys", "type": "boolean", "description": "[buySignals] In the trades feed, keep only opening (new buy) trades.", "default": true }, "tokens": { "title": "Tokens", "type": "array", "description": "[rugcheck · tokenHolders] Tokens to analyze. Each entry: { chain, address }. Required for the rugcheck and tokenHolders modes." }, "includeSecurity": { "title": "[rugcheck] Include security audit", "type": "boolean", "description": "[rugcheck] Honeypot, blacklist, renounced, taxes, lock, audit.", "default": true }, "includeDevInfo": { "title": "[rugcheck] Include dev/creator info", "type": "boolean", "description": "[rugcheck] Creator, Twitter history, fund origin, boost flags.", "default": true }, "includeTokenStat": { "title": "[rugcheck] Include holder/trader stats", "type": "boolean", "description": "[rugcheck] Bluechip %, signal/degen counts, bundler/sniper/fresh rates.", "default": true }, "includeAth": { "title": "[rugcheck] Include ATH", "type": "boolean", "description": "[rugcheck] All-time-high market cap and source.", "default": true }, "includeBundlerStat": { "title": "[rugcheck] Include bundler stats", "type": "boolean", "description": "[rugcheck] Per-bundler share, bundled-buy count and volume.", "default": false }, "includePoolFee": { "title": "[rugcheck] Include pool/fee info", "type": "boolean", "description": "[rugcheck] DEX, liquidity, fee ratio, dynamic-fee configs.", "default": false }, "includeRecommendSlippage": { "title": "[rugcheck] Include recommended slippage", "type": "boolean", "description": "[rugcheck] GMGN recommended buy/sell slippage + volatility.", "default": false }, "includeRugVote": { "title": "[rugcheck] Include rug vote/links", "type": "boolean", "description": "[rugcheck] Community rug vote, rug ratio, full social links.", "default": true }, "includeLogoHistory": { "title": "[rugcheck] Include logo history", "type": "boolean", "description": "[rugcheck] Every logo change with timestamp (rug signal).", "default": false }, "includeMcapCandles": { "title": "[rugcheck] Include market-cap candles", "type": "boolean", "description": "[rugcheck] OHLC market-cap candles; one row per candle.", "default": false }, "candleResolution": { "title": "[rugcheck] Candle resolution", "enum": [ "1m", "5m", "15m", "30m", "1h", "4h", "1d" ], "type": "string", "description": "[rugcheck] Resolution for market-cap candles (when enabled).", "default": "1h" }, "includeBluechipRank": { "title": "[rugcheck] Include chain bluechip rank", "type": "boolean", "description": "[rugcheck] Also fetch the chain-wide bluechip-token rank as separate rows.", "default": false }, "maxHoldersPerToken": { "title": "[tokenHolders] Max holders per token", "minimum": 1, "maximum": 10000, "type": "integer", "description": "[tokenHolders] How many holders to page through per token.", "default": 500 }, "holdersOrderBy": { "title": "[tokenHolders] Holders order by", "enum": [ "amount_percentage", "amount", "last_active_timestamp" ], "type": "string", "description": "[tokenHolders] Sort field for the holder list.", "default": "amount_percentage" }, "includeHolderStat": { "title": "[tokenHolders] Include holder stat", "type": "boolean", "description": "[tokenHolders] Per-token holder category counts.", "default": true }, "includeWalletTagsStat": { "title": "[tokenHolders] Include wallet tags stat", "type": "boolean", "description": "[tokenHolders] Tagged-wallet lists (smart, sniper, whale...).", "default": true }, "includeTopBuyers": { "title": "[tokenHolders] Include top buyers", "type": "boolean", "description": "[tokenHolders] Top-buyers feed per token.", "default": false }, "onlyHolders": { "title": "[tokenHolders] Only current holders", "type": "boolean", "description": "[tokenHolders] Drop zero-balance (exited) holders.", "default": false }, "wallets": { "title": "Wallets", "type": "array", "description": "[walletPnl] Wallets to track. Each entry: { chain, address }. Required for the walletPnl mode." }, "maxHoldingsPerWallet": { "title": "Max holdings per wallet", "minimum": 1, "maximum": 2000, "type": "integer", "description": "[walletPnl] Cap per-token holdings (best-effort; GMGN may gate this).", "default": 200 }, "walletPnlOrderBy": { "title": "Holdings order by", "enum": [ "last_active_timestamp", "total_value", "unrealized_profit" ], "type": "string", "description": "[walletPnl] Sort field for holdings.", "default": "last_active_timestamp" }, "includePnlPeriods": { "title": "PnL periods", "uniqueItems": true, "type": "array", "description": "[walletPnl] Per-period PnL windows to pull.", "items": { "type": "string", "enum": [ "1d", "7d", "30d" ], "enumTitles": [ "1 day", "7 days", "30 days" ] }, "default": [ "7d" ] }, "includeWalletSummary": { "title": "Include wallet summary", "type": "boolean", "description": "[walletPnl] Primary wallet summary row.", "default": true }, "includeNativeTransfers": { "title": "Include funding source", "type": "boolean", "description": "[walletPnl] Native funding source (who funded the wallet).", "default": false }, "includeHoldings": { "title": "Include per-token holdings", "type": "boolean", "description": "[walletPnl] Best-effort per-token holdings (auth-gated by GMGN; skipped silently if blocked).", "default": false }, "hideSmall": { "title": "Hide small holdings", "type": "boolean", "description": "[walletPnl] Hide dust positions.", "default": false }, "sellout": { "title": "Include sold-out positions", "type": "boolean", "description": "[walletPnl] Include fully-exited positions.", "default": true }, "hideAbnormal": { "title": "Hide abnormal", "type": "boolean", "description": "[walletPnl] Hide abnormal positions.", "default": false }, "minTotalValueUsd": { "title": "Min holding value (USD)", "type": "integer", "description": "[walletPnl] Drop holdings below this USD value. 0 = no filter.", "default": 0 }, "feeds": { "title": "Feeds", "uniqueItems": true, "type": "array", "description": "[signalsFeed] Which social feeds to poll.", "items": { "type": "string", "enum": [ "twitter", "telegram" ], "enumTitles": [ "Twitter / X", "Telegram" ] }, "default": [ "twitter", "telegram" ] }, "userTags": { "title": "User tags (Twitter)", "type": "array", "description": "[signalsFeed] KOL tag filter for the Twitter feed.", "default": [ "kol", "trader", "master", "founder", "exchange" ], "items": { "type": "string" } }, "twTypes": { "title": "Tweet types", "type": "array", "description": "[signalsFeed] Tweet types to include.", "default": [ "tweet", "repost", "quote", "reply", "pin" ], "items": { "type": "string" } }, "hasToken": { "title": "Only messages with a token", "type": "boolean", "description": "[signalsFeed] Twitter: only messages that reference a token.", "default": false }, "featuredOnly": { "title": "Featured only (Twitter)", "type": "boolean", "description": "[signalsFeed] Twitter: featured messages only.", "default": false }, "mineOnly": { "title": "Mine only (Twitter)", "type": "boolean", "description": "[signalsFeed] Twitter: followed accounts only.", "default": false }, "tgFeatured": { "title": "Featured only (Telegram)", "type": "boolean", "description": "[signalsFeed] Telegram: featured messages only.", "default": false }, "tgLimit": { "title": "Telegram limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "[signalsFeed] Max Telegram messages per poll.", "default": 30 }, "pollIterations": { "title": "Poll iterations", "minimum": 1, "maximum": 120, "type": "integer", "description": "[signalsFeed] How many polling snapshots to take in one run.", "default": 1 }, "pollIntervalSec": { "title": "Poll interval (sec)", "minimum": 5, "maximum": 600, "type": "integer", "description": "[signalsFeed] Seconds between polls.", "default": 30 }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "[all modes] Route requests through Apify Proxy. Strongly recommended ON.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "[all modes] Apify Proxy group. The default (automatic datacenter) handles GMGN.ai fine and is by far the cheapest. Switch to RESIDENTIAL only if you start seeing blocks under heavy load.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "[all modes] Parallel GMGN API calls. 5-10 is safe.", "default": 8 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }