# GMGN Trader Leaderboard Scraper (x402)

> GMGN Trader Leaderboard Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Returns ranked lists of on-chain trader wallets from GMGN's public leaderboard, filtered and sorted by profit, win rate, volume, and other metrics across multiple blockchains.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-leaderboard-scraper-x402-a9e04120
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4cVPy0u_ycGiT2HQlkRw3

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-leaderboard-scraper-x402-a9e04120 -d '<json body>'
```

Example prompt: Pull the top 50 most profitable smart money wallets on Solana over the last 7 days from GMGN, filtering for wallets with at least 60% win rate, and sort them by profit descending.

## When to prefer this

Choose this endpoint when you need structured, ranked wallet data from GMGN's public leaderboard without building your own scraper. It is ideal for on-chain alpha research, copy-trading list generation, bot detection, and wallet intelligence workflows. Prefer it over generic web scraping when you need clean, typed wallet metrics (profit, win rate, volume) across specific chains and time windows, and when you only want to pay for successful, non-empty results.

## Known failure modes

- Empty result set if filters are too restrictive — not charged
- Chain or period enum mismatch returns a validation error
- Limit above 200 is rejected; some sort types cap results at 100
- Network or scraping failure on GMGN's side returns an error — not charged
- Invalid filter key names or out-of-range percent values (outside 0–100) may be silently ignored or cause errors

## How this service works

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

## Output

A JSON object with a count of returned wallets and an items array, each item containing wallet address, avatar, average cost over 1d/7d/30d windows, average holding period over 1d/7d/30d, and ARC balance. The product field confirms the data source (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-leaderboard-scraper-x402-a9e04120/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)