# x4o2 StonkFun SPL Token Burns

> x4o2 StonkFun SPL Token Burns 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).

Retrieves observed SPL token burn events for a given Solana token mint address, paginated, with partial-history caveat

## Facts

- Endpoint: GET https://stonk.x4o2.com/v1/tokens/:mint/burns?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-spl-token-burns-d09a9405
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W7d4EXoTLYbE5ZY8eZJO3

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-spl-token-burns-d09a9405
```

Example prompt: Pull the burn history for Solana token mint So11111111111111111111111111111111111111112 — give me the first 50 burn events so I can see how much supply has been destroyed.

## When to prefer this

Use this endpoint when you specifically need historical SPL token burn events on Solana for a known mint address and can tolerate potentially incomplete history (partial flag). It is purpose-built for StonkFun/Stonk platform tokens and provides freshness and commitment metadata. Prefer alternatives if you need real-time streaming burns, complete guaranteed history, or data outside the Solana/SPL ecosystem.

## Known failure modes

- Invalid or unknown mint address returns empty data or 404
- partial:true flag indicates burn history is incomplete — not all burns may be indexed
- offset exceeds 250000 cap causing parameter validation error
- limit outside 1–100 range rejected with validation error
- Stale data if freshnessSeconds is high — on-chain state may have advanced
- Payment failure (x402) if USDC not available — endpoint requires $0.001 per call

## How this service works

Observed SPL token burns; incomplete history

## Output

A paginated list of observed SPL token burn events for the requested mint, including each burn item's details, cumulative totalBurned amount, pagination metadata (limit, offset), a partial boolean indicating incomplete history, and freshness metadata (ageMs, observedAt, discoveryAt, freshnessSeconds, commitment level, source).

## 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": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "description": "Exact Solana token mint"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "minimum": 1,
       "description": "Page size"
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "maximum": 250000,
       "minimum": 0,
       "description": "Offset"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "data": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "mint": {
         "type": [
          "string",
          "null"
         ]
        },
        "items": {
         "type": [
          "array",
          "null"
         ]
        },
        "limit": {
         "type": [
          "number",
          "null"
         ]
        },
        "offset": {
         "type": [
          "number",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "totalBurned": {}
       }
      },
      "meta": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "ageMs": {},
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "commitment": {
         "type": [
          "string",
          "null"
         ]
        },
        "observedAt": {},
        "discoveryAt": {
         "type": [
          "string",
          "null"
         ]
        },
        "freshnessSeconds": {
         "type": [
          "number
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-stonkfun-spl-token-burns-d09a9405/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)