# x4o2 StonkFun On-chain Rewards Data

> x4o2 StonkFun On-chain Rewards Data 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 fee events and reward distribution records for Solana SPL tokens, paginated by mint address

## Facts

- Endpoint: GET https://stonk.x4o2.com/v1/rewards?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-rewards-data-6ede30cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7DU509sTMDxsaPFv0GdDI

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-rewards-data-6ede30cd
```

Example prompt: Show me the latest reward and fee distribution events for Solana mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — get the first 20 results.

## When to prefer this

Use this endpoint when you need paginated on-chain fee event or reward distribution records for a specific Solana SPL token mint address on the StonkFun/Stonk platform. Prefer this over general Solana RPC calls when you want pre-indexed, structured reward data with freshness metadata. Note that reward distribution coverage may be incomplete — check the partial and coverage fields before drawing conclusions.

## Known failure modes

- Invalid or non-existent mint address returns empty items array or partial flag set to true
- offset exceeding 250000 returns an error
- limit out of range (below 1 or above 100) returns a validation error
- Reward distribution history may be incomplete — partial flag will be true and coverage string will indicate gaps
- Service may return stale data — check ageMs and freshnessSeconds in meta

## How this service works

Observed fee events; holder reward distributions unknown

## Output

Returns a paginated list of observed on-chain reward distribution and fee events for a given Solana token mint, along with metadata including data age, source, commitment level, observation timestamp, discovery timestamp, freshness in seconds, and whether the result is partial. Coverage field indicates completeness of the history. The rewardDistributions field may be unpopulated.

## 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": {
      "mint": {
       "type": "string",
       "description": "Exact Solana token mint"
      },
      "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": {
        "items": {
         "type": [
          "array",
          "null"
         ],
         "items": {
          "type": [
           "object",
           "null"
          ]
         }
        },
        "limit": {
         "type": [
          "number",
          "null"
         ]
        },
        "offset": {
         "type": [
          "number",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "coverage": {
         "type": [
          "string",
          "null"
         ]
        },
        "rewardDistributions": {}
       }
      },
      "meta": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "ageMs": {
         "type": [
          "number",
          "null"
         ]
        },
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "commitment": {
         "type": [
          "string",
          "null"
         ]
        },
        "observedAt": {
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-stonkfun-on-chain-rewards-data-6ede30cd/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)