{ "openapi": "3.0.1", "info": { "title": "GMGN Trending Memecoin Scanner — Multi-Chain Token API", "description": "Scrape trending memecoins from GMGN.ai across Solana, BSC, Ethereum, Base, Tron, Monad. 80+ fields per token: price, volume, liquidity, market cap, holders, smart-money count, security audit, taxes, Twitter, Telegram. Pick timeframes (1m/5m/1h/24h) and security filters.", "version": "1.0", "x-build-id": "lnyTTcb00HoPwOltT" }, "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": { "chains": { "title": "Chains", "uniqueItems": true, "type": "array", "description": "Which blockchains to scan. Pick one or more. Solana (sol) and BSC (bsc) are the highest-volume memecoin chains. Ethereum (eth), Base (base), Tron (tron), and Monad (monad) are also supported. Default scans all six 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": "Which timeframes to scan. '1m' = last minute, '5m' = last 5 minutes, '1h' = last hour, '24h' = last 24 hours. Shorter timeframes surface the freshest hot tokens; '24h' is best for stable, established trending tokens. Default scans all four.", "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", "uniqueItems": true, "type": "array", "description": "Token security filters applied by GMGN before ranking. 'not_honeypot' excludes honeypots (cannot-sell scams). 'verified' keeps verified contracts. 'renounced' keeps tokens where the dev renounced ownership. 'frozen' keeps tokens with frozen liquidity. 'no_mint_authority' excludes tokens where the dev can mint more. Leave empty for the full unfiltered list (more results, more noise).", "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", "enum": [ "", "volume", "market_cap", "swaps", "holder_count", "price_change_percent", "smart_degen_count", "liquidity" ], "type": "string", "description": "How to sort tokens before truncation. Default (score) is GMGN's internal hot-score combining volume, social signals, and smart-money activity. 'volume' sorts by trading volume in the timeframe, 'market_cap' by FDV, 'swaps' by transaction count, 'holder_count' by number of holders, 'price_change_percent' by % price change, 'smart_degen_count' by number of smart-money wallets holding.", "default": "" }, "direction": { "title": "Sort Direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort direction. 'desc' (highest first) is the default and matches the GMGN UI. 'asc' surfaces low-end tokens — useful for hunting tokens about to break out.", "default": "desc" }, "maxResultsPerCall": { "title": "Max Results per API Call", "minimum": 10, "maximum": 100, "type": "integer", "description": "Number of tokens returned per (chain, timeframe) request. Max 100 (GMGN limit). Higher = more results per run.", "default": 100 }, "minVolumeUsd": { "title": "Minimum Volume (USD)", "minimum": 0, "type": "integer", "description": "Drop tokens whose timeframe volume is below this USD threshold. Default 0 = no filter. Set 1000+ to filter out micro-cap noise.", "default": 0 }, "minLiquidityUsd": { "title": "Minimum Liquidity (USD)", "minimum": 0, "type": "integer", "description": "Drop tokens with liquidity below this USD threshold. Default 0 = no filter. Set 5000+ to focus on tradable tokens.", "default": 0 }, "minHolderCount": { "title": "Minimum Holder Count", "minimum": 0, "type": "integer", "description": "Drop tokens with fewer than this many holders. Default 0 = no filter.", "default": 0 }, "minSmartMoneyCount": { "title": "Minimum Smart Money Holders", "minimum": 0, "type": "integer", "description": "Drop tokens that have fewer than this many smart-money wallets holding. Set 3+ to focus on smart-money-validated tokens.", "default": 0 }, "maxAgeHours": { "title": "Max Token Age (hours)", "minimum": 0, "type": "integer", "description": "Drop tokens older than this many hours (based on open_timestamp). Default 0 = no age filter. Set 24 for last-day launches only.", "default": 0 }, "includeBinanceDex": { "title": "Include Binance DEX Rank (BSC only)", "type": "boolean", "description": "Also fetch the dedicated Binance DEX rank for BSC (a curated list pushed by GMGN's Binance partnership). Adds up to 100 extra BSC tokens.", "default": true }, "deduplicate": { "title": "Deduplicate Tokens", "type": "boolean", "description": "When ON, the same token contract across timeframes is emitted once with the freshest data and an array of which timeframes it appeared in. When OFF, the same token may appear multiple times (once per timeframe).", "default": false }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy. Recommended ON for larger runs to avoid Cloudflare rate limits. Adds Apify proxy units to the run cost.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Choose the Apify proxy group. RESIDENTIAL gives the highest success rate against Cloudflare and is the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max Concurrent Requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many GMGN API calls to run in parallel. Higher is faster but more likely to trip rate limits. 5-10 is a safe range.", "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 } } } } } } } } } }