# x4o2 StonkFun Trending Tokens by Volume or Market Cap

> x4o2 StonkFun Trending Tokens by Volume or Market Cap 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 list of SPL tokens trending by 24h swap volume or market cap within a specified quote mint on the Stonk platform

## Facts

- Endpoint: GET https://stonk.x4o2.com/v1/trending?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-trending-tokens-by-volume-or-market-cap-3bb70522
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0zS9im428tX7F6Fc9Wqj1

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-trending-tokens-by-volume-or-market-cap-3bb70522
```

Example prompt: Pull the top 20 trending tokens on Stonk sorted by 24h swap volume for the SOL quote mint and show me which ones are gaining the most traction right now.

## When to prefer this

Use this endpoint when you need a real-time ranked leaderboard of SPL tokens by trading activity or market cap within a specific quote mint on the Stonk platform. It is the right choice for trend discovery, token screening, or building dashboards that surface the most active or largest on-chain tokens. Prefer this over raw pool or mint endpoints when you want pre-sorted aggregated metrics rather than individual token or pool details.

## Known failure modes

- Missing or invalid quoteMint returns empty or error response
- Invalid sort enum value (not 'volume' or 'mcap') causes validation failure
- limit exceeding 100 is rejected
- Partial data flag set to true when on-chain indexing is incomplete
- Stale data returned if the indexer has not recently observed swaps
- Rate limit or payment failure returns 402 Payment Required

## How this service works

24h observed swap volume or fresh market cap within one quote mint

## Output

Returns a paginated list of trending SPL tokens ranked by either 24h observed swap volume or market cap within a specified quote mint. Each item includes token identifiers, ranking metric values, and metadata such as observation timestamp, data age in milliseconds, source, freshness in seconds, and whether the result set is partial.

## 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-trending-tokens-by-volume-or-market-cap-3bb70522/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)