{ "openapi": "3.0.1", "info": { "title": "GMGN Smart Money Wallet Leaderboard — Top Crypto Traders", "description": "Top crypto trader leaderboard from GMGN.ai across Solana, BSC, Ethereum, Base, Tron, Monad. Rank by 1d/7d/30d PnL, winrate, volume. 50+ fields per wallet: realized profit, winrate, txs, holding period, daily profit history, tags (smart_degen, KOL, fresh), Twitter, ENS.", "version": "1.0", "x-build-id": "OXuhWg8cUFAW18keV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~gmgn-smart-money-wallet-leaderboard/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-gmgn-smart-money-wallet-leaderboard", "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-smart-money-wallet-leaderboard/runs": { "post": { "operationId": "runs-sync-logiover-gmgn-smart-money-wallet-leaderboard", "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-smart-money-wallet-leaderboard/run-sync": { "post": { "operationId": "run-sync-logiover-gmgn-smart-money-wallet-leaderboard", "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 chains to scan for top traders. Each chain has its own leaderboard. Default scans Solana and BSC (highest activity). All six chains: sol, bsc, eth, base, tron, monad.", "items": { "type": "string", "enum": [ "sol", "bsc", "eth", "base", "tron", "monad" ], "enumTitles": [ "Solana", "BSC", "Ethereum", "Base", "Tron", "Monad" ] }, "default": [ "sol", "bsc", "eth", "base", "tron", "monad" ] }, "periods": { "title": "Lookback Periods", "uniqueItems": true, "type": "array", "description": "Lookback window for PnL ranking. '1d' = last 24h, '7d' = last week, '30d' = last month. Default scans 1d and 7d.", "items": { "type": "string", "enum": [ "1d", "7d", "30d" ], "enumTitles": [ "24 hours", "7 days", "30 days" ] }, "default": [ "1d", "7d", "30d" ] }, "orderByList": { "title": "Order By (multiple)", "uniqueItems": true, "type": "array", "description": "Sort the leaderboard by these metrics — the actor runs one request per orderBy and merges the results. Higher = more results per run. 'pnl_1d/7d/30d' = realized PnL multiplier. 'realized_profit_1d/7d/30d' = USD profit. 'winrate_1d/7d/30d' = win rate (0-1). 'volume_1d/7d/30d' = total USD volume. 'txs_1d/7d/30d' = total transaction count.", "items": { "type": "string", "enum": [ "pnl_1d", "pnl_7d", "pnl_30d", "realized_profit_1d", "realized_profit_7d", "realized_profit_30d", "winrate_1d", "winrate_7d", "winrate_30d", "volume_1d", "volume_7d", "volume_30d", "txs_1d", "txs_7d", "txs_30d" ], "enumTitles": [ "PnL × (1d)", "PnL × (7d)", "PnL × (30d)", "Realized $ (1d)", "Realized $ (7d)", "Realized $ (30d)", "Winrate (1d)", "Winrate (7d)", "Winrate (30d)", "Volume (1d)", "Volume (7d)", "Volume (30d)", "Txs (1d)", "Txs (7d)", "Txs (30d)" ] }, "default": [ "pnl_7d", "realized_profit_7d", "volume_7d", "txs_7d", "winrate_7d" ] }, "direction": { "title": "Sort Direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort direction. desc = highest first (default, matches the source UI). asc = lowest first — useful for hunting unfamiliar entries.", "default": "desc" }, "minPnl": { "title": "Minimum PnL Multiplier", "type": "number", "description": "Drop wallets whose PnL multiplier (in the picked period) is below this. e.g. 1.5 = 50% gain.", "default": 0 }, "minRealizedProfitUsd": { "title": "Minimum Realized Profit (USD)", "minimum": 0, "type": "integer", "description": "Drop wallets whose realized profit (in the picked period) is below this USD amount.", "default": 0 }, "minWinrate": { "title": "Minimum Winrate (0-1)", "minimum": 0, "maximum": 1, "type": "number", "description": "Drop wallets below this winrate (0-1). E.g. 0.5 = 50%.", "default": 0 }, "minTxs": { "title": "Minimum Transactions", "minimum": 0, "type": "integer", "description": "Drop wallets with fewer trades in the period — filters out lucky one-shot wallets.", "default": 0 }, "minVolumeUsd": { "title": "Minimum Volume (USD)", "minimum": 0, "type": "integer", "description": "Drop rows whose USD volume is below this threshold. Default 0 = no filter.", "default": 0 }, "onlyWithTwitter": { "title": "Only Wallets With Twitter", "type": "boolean", "description": "Keep only wallets that have a Twitter / X handle linked. Useful for KOL / public-figure discovery.", "default": false }, "tagFilter": { "title": "Tag Filter", "type": "array", "description": "Keep only wallets carrying one of these GMGN tags. Common values: 'smart_degen', 'renowned', 'fresh_wallet', 'kol', 'exchange', 'fund', 'pump_smart_degen', 'sniper'. Leave empty to keep all.", "default": [], "items": { "type": "string" } }, "deduplicate": { "title": "Deduplicate Wallets", "type": "boolean", "description": "When ON, a wallet returned by multiple (chain, period, orderBy) calls is emitted once, with the merged metadata. When OFF, each combination produces a separate row (useful for studying which ranking surfaced a wallet).", "default": false }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy. Strongly recommended ON — residential proxy is the most reliable way to bypass Cloudflare rate limits.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxy group is recommended for the highest success rate against Cloudflare.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max Concurrent Requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of API calls running in parallel. Higher = faster runs but more chance of hitting rate limits. 3-5 is safe.", "default": 5 } } }, "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 } } } } } } } } } }