# GMGN Trader Wallet Rankings API

> GMGN Trader Wallet Rankings API is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

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.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/gmgn?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gmgn-trader-wallet-rankings-api-b06a567c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DGNKMhuv7jaFDMBBMm2j5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gmgn-trader-wallet-rankings-api-b06a567c -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

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'.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "avatar": null,
    "address": null,
    "avgCost1d": null,
    "avgCost7d": null,
    "arcBalance": null,
    "avgCost30d": null,
    "avgHoldingPeriod1d": null,
    "avgHoldingPeriod7d": null
   }
  ],
  "product": "gmgn"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gmgn-trader-wallet-rankings-api-b06a567c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)