# Agent402 x402 Trending Sellers Leaderboard

> Agent402 x402 Trending Sellers Leaderboard is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns a ranked leaderboard of trending x402 sellers by on-chain Base USDC settlements, enriched with wash-trade-resistant organic scores and buyer diversity signals

## Facts

- Endpoint: GET https://agent402.tools/api/x402-trending
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-x402-trending-sellers-leaderboard-5501468d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gC6cXi_xR8Hx8xgrCmnI2

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 agent402-x402-trending-sellers-leaderboard-5501468d
```

Example prompt: Show me the top 20 trending x402 sellers right now, ranked by organic score to filter out wash trades, and exclude Agent402's own wallet from the results.

## When to prefer this

Use this endpoint when you need a wash-trade-resistant, multi-signal view of x402 seller momentum rather than raw settlement totals. It is the right choice when you need organic buyer diversity scoring, want to exclude internal wallets, or need to sort by distinct paying wallets rather than raw volume. Prefer this over generic blockchain explorers when you want pre-processed, agent-ready leaderboard data for the x402 seller ecosystem specifically.

## Known failure modes

- limit out of range (1-50) returns validation error
- invalid sort enum value returns 400 bad request
- on-chain data may lag up to one hour if leaderboard hasn't refreshed
- no sellers returned if ecosystem has zero activity in the window
- payment failure (402) if USDC balance is insufficient

## How this service works

Momentum radar for the x402 seller ecosystem - which sellers are heating up, graded for wash-trade resistance. Reads the hourly on-chain leaderboard (real Base USDC settlements) and adds per-seller signals the raw board doesn't have: organicScore (uniqueBuyers/callsSettled - 1000 calls from 2 buyers smells like self-dealing, 1000 from 400 is organic demand) and avgTicketUsd.

## Output

A ranked list of up to 50 x402 sellers with per-seller signals including USDC settlement volume, raw call counts, organicScore (buyer diversity metric), and distinct paying wallet count — sourced from the hourly on-chain Base USDC leaderboard. The sort order and inclusion filter reflect the query parameters supplied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "enum": [
        "usd",
        "calls",
        "organic",
        "buyers"
       ],
       "type": "string",
       "description": "Ranking lens: usd=USDC settled (default), calls=raw volume, organic=organicScore (buyer diversity), buyers=distinct paying wallets"
      },
      "limit": {
       "type": "integer",
       "description": "How many sellers to return (1-50, default 10)"
      },
      "include": {
       "enum": [
        "external",
        "all"
       ],
       "type": "string",
       "description": "external (default) excludes Agent402's own wallet; all keeps it"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "window",
      "sort",
      "include",
      "limit",
      "totalSellers",
      "sellers",
      "wow",
      "snapshotAsOf",
      "generatedAt"
     ],
     "properties": {
      "wow": {
       "type": "object",
       "properties": {
        "note": {
         "type": "string"
        },
        "available": {
         "type": "boolean"
        }
       }
      },
      "sort": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "window": {
       "type": "string"
      },
      "include": {
       "type": "string"
      },
      "sellers": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "generatedAt": {
       "type": "string"
      },
      "snapshotAsOf": {
       "type": "string"
      },
      "totalSellers": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "wow": {
   "note": "no persisted snapshot ~7 days old yet - week-over-week deltas activate automatically as history accrues",
   "available": false
  },
  "sort": "usd",
  "limit": 10,
  "window": "24h",
  "include": "external",
  "sellers": [
   {
    "name": "example-seller",
    "rank": 1,
    "wallet": "0x1111111111111111111111111111111111111111",
    "network": "base",
    "homepage": "https://seller.example",
    "totalUsd": 41.2,
    "avgTicketUsd": 0.011635,
    "callsSettled": 3541,
    "organicScore": 0.1135,
    "uniqueBuyers": 402
   }
  ],
  "generatedAt": "2026-07-14T00:00:05.000Z",
  "snapshotAsOf": "2026-07-14T00:00:00.000Z",
  "totalSellers": 214
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-x402-trending-sellers-leaderboard-5501468d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)