# x4o2 StonkFun On-chain Leaderboard (Quote-Specific Trending)

> x4o2 StonkFun On-chain Leaderboard (Quote-Specific Trending) is a paid API for AI agents from stonk.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Returns a ranked leaderboard of tokens within a specific quote mint, sorted by volume or market cap over a recent window.

## Facts

- Endpoint: GET https://stonk.x4o2.com/v1/leaderboard?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x4o2-stonkfun-on-chain-leaderboard-quote-specific-trending-1f0ed9a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JIS9a_LxY881etGIjSuvf

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 x4o2-stonkfun-on-chain-leaderboard-quote-specific-trending-1f0ed9a7
```

Example prompt: Pull the top 20 trending tokens on StonkFun for the quote mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, ranked by volume.

## When to prefer this

Use this endpoint when you need a ranked list of tokens within a specific quote mint on StonkFun, sorted by either trading volume or market cap. Prefer this over individual token lookups when you want aggregate trending data or need to surface the most active tokens in a quote market. It is the canonical leaderboard endpoint for quote-specific trending on the Stonk platform.

## Known failure modes

- Missing or invalid quoteMint returns an empty or error response
- sort parameter outside allowed enum (volume/mcap) causes a validation error
- limit out of range (below 1 or above 100) triggers a bad request error
- Stale data may be returned if ingestion pipeline is delayed, indicated by high ageMs in metadata
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Alias of quote-specific trending

## Output

Returns a paginated list of ranked token items for the given quote mint, including sort metric used, window duration in seconds, page size, and a partial flag indicating whether the result is complete. Metadata includes data age in milliseconds, source, commitment level, and freshness in seconds.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [],
     "properties": {}
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "sort": {
       "enum": [
        "volume",
        "mcap"
       ],
       "type": "string",
       "default": "volume",
       "description": "Ranking metric"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "minimum": 1,
       "description": "Page size"
      },
      "quoteMint": {
       "type": "string",
       "description": "Exact quote mint; required for ranking or candles"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "data": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "sort": {
         "type": [
          "string",
          "null"
         ]
        },
        "items": {
         "type": [
          "array",
          "null"
         ]
        },
        "limit": {
         "type": [
          "number",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "quoteMint": {
         "type": [
          "string",
          "null"
         ]
        },
        "windowSeconds": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "meta": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "ageMs": {
         "type": [
          "number",
          "null"
         ]
        },
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "commitment": {
         "type": [
          "string",
          "null"
         ]
        },
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-stonkfun-on-chain-leaderboard-quote-specific-trending-1f0ed9a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stonk.x4o2.com](https://www.zero.xyz/host/stonk.x4o2.com/llms.txt)