{"uid":"cap_DGNKMhuv7jaFDMBBMm2j5","slug":"gmgn-trader-wallet-rankings-api-b06a567c","name":"GMGN Trader Wallet Rankings API","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/gmgn?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["sol","eth","bsc","base","tron","monad","hyperevm","megaeth","robinhood","xlayer"],"type":"string","default":"sol","description":"Blockchain whose public trader ranking is queried."},"limit":{"type":"integer","default":100,"maximum":200,"minimum":1,"description":"Maximum distinct wallets to export. The endpoint returns up to 100 per response; numeric sorts can collect a second filtered slice. Other sorts may stop at 100."},"period":{"enum":["1d","7d","30d"],"type":"string","default":"7d","description":"Time window for the ranking and period-based filters. Each result still includes all available 1, 7, and 30 day statistics."},"sortBy":{"enum":["profit","winRate","transactions","volume","netInflow","lastActivity","balance","tracked","renamed"],"type":"string","default":"profit","description":"Metric used to rank wallets. Profit means realized profit in USD for the selected period."},"filters":{"type":"object","default":{},"description":"Optional min/max bounds for the selected period: minProfitUsd, maxProfitUsd, minPnlPercent, maxPnlPercent, minWinRatePercent, maxWinRatePercent, minTransactions, maxTransactions, minVolumeUsd, maxVolumeUsd, minNetInflowUsd, maxNetInflowUsd, minAverageCostUsd, maxAverageCostUsd. Percent inputs use 0–100."},"traderType":{"enum":["all","pump_smart","launchpad_smart","smart_degen","renowned","live","fresh_wallet","snipe_bot","top_followed","top_renamed","top_dev"],"type":"string","default":"all","description":"Public ranking category. Smart Money includes both smart and pump traders, as on the ranking page."},"sortDirection":{"enum":["desc","asc"],"type":"string","default":"desc","description":"Descending shows the highest values first; ascending shows the lowest values first."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"avatar":null,"address":null,"avgCost1d":null,"avgCost7d":null,"arcBalance":null,"avgCost30d":null,"avgHoldingPeriod1d":null,"avgHoldingPeriod7d":null}],"product":"gmgn"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0sdCNE0QfsKaTO_U6UVaD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches ranked lists of on-chain trader wallets from GMGN across multiple blockchains, sorted by profit, win rate, volume, or other metrics with optional filters.","exampleAgentPrompt":"Pull the top 50 Solana wallets from GMGN ranked by profit over the last 7 days, only smart_degen trader types, and filter to wallets with at least 60% win rate.","exampleUseCases":[{"title":"Find top Solana smart money wallets","prompt":"Get me the top 100 smart money wallets on Solana from GMGN sorted by profit over the last 30 days — I want to see who's been consistently printing money this month."},{"title":"Identify high win-rate snipe bots","prompt":"Pull a list of up to 200 snipe_bot wallets on BSC from GMGN, sorted by win rate descending over the past 7 days, and filter to only ones with at least 70% win rate and more than 50 transactions."},{"title":"Track fresh wallet activity on Base","prompt":"Show me the top fresh_wallet traders on Base ranked by net inflow over the last 24 hours from GMGN — I want to spot new wallets that are already moving serious volume."}],"resultDescription":"Returns a JSON object with a count of matched wallets and an array of wallet items, each containing fields such as wallet address, avatar, average cost over 1/7/30-day windows, average holding period, and ARC balance. The product field confirms the data source as 'gmgn'.","failureModes":["Invalid blockchain enum value returns validation error","Limit exceeding 200 returns error or is clamped","Unsupported filter keys are silently ignored or cause bad request","Empty result set (no wallets match filters) returns count:0 with empty items array — not charged","Network timeout if GMGN upstream is slow","Some sort modes (e.g. 'tracked', 'renamed') may cap results at 100 regardless of limit"],"whenToPreferThis":"Choose this endpoint when you need ranked on-chain wallet leaderboard data from GMGN specifically, across multiple chains including Solana, Ethereum, BSC, Base, and newer chains like Monad and MegaETH. Prefer this over generic blockchain explorers when you want pre-ranked, categorized trader lists (smart money, snipe bots, pump traders, etc.) with period-based performance metrics. It is pay-per-call and only charges on successful non-empty responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.045Z","isFirstParty":false,"canonicalSlug":"gmgn-trader-wallet-rankings-api-b06a567c"}