# SolEnrich StonkFun Gem Finder

> SolEnrich StonkFun Gem Finder is a paid API for AI agents from api.solenrich.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-16).

Scores and stages StonkFun reward coins (0–100) for gem potential using holder data, market cap, turnover, momentum, and flywheel metrics, returning GEM/WATCH/NOISE/DEAD classifications with reasons and round-trip tax costs.

## Facts

- Endpoint: POST https://api.solenrich.com/entrypoints/stonk-gems/invoke
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solenrich-stonkfun-gem-finder-80d8c4ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pxv_L1j3EDIAzYWP9sZW6

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 solenrich-stonkfun-gem-finder-80d8c4ce -d '<json body>'
```

Example prompt: Scan StonkFun reward coins right now and show me the top 20 GEM or WATCH stage tokens in the xstock category that are under 14 days old, have at least 25 holders, and are under $5M market cap — I want scores, reasons, and the round-trip tax cost for each.

## When to prefer this

Use this endpoint when you need a fast, scored ranking of StonkFun reward coins specifically — not generic Solana token analytics. It is the right choice when you want to surface early-stage, real, paying coins before they saturate, with built-in filtering by category, age, holders, and market cap. Prefer it over general Solana token enrichment endpoints when your goal is gem discovery with flywheel and momentum scoring rather than deep per-token wallet or liquidity analysis.

## Known failure modes

- No coins match the applied filters (empty result set returned)
- Invalid quote_mint address format (32–44 character base58 required)
- max_age_days or max_market_cap_usd out of allowed range
- limit exceeds maximum of 50
- Payment not attached or insufficient USDC (x402 payment required at $0.03 per call)
- StonkFun index data temporarily unavailable or stale (millisecond freshness not guaranteed under outage)

## How this service works

Gem finder over every StonkFun reward coin: which look early, real, and paying? Scores 0-100 from the 10-minute index — recent holder payout, holders (found but not saturated), market cap headroom, 24h turnover, age, momentum (not yet parabolic), quote-asset strength, flywheel. Stages GEM / WATCH / NOISE / DEAD with plain reasons and warnings per coin, plus the round-trip tax cost. Filters: quote_mint, category, max_age_days, min_holders, max_market_cap_usd. Milliseconds.

## Output

Returns a ranked list of up to 50 StonkFun reward coins, each with a 0–100 gem score, GEM/WATCH/NOISE/DEAD stage label, plain-language reasons for the classification, specific warnings, holder count, market cap, 24h turnover, momentum status, quote-asset strength indicator, flywheel signal, and estimated round-trip tax cost. Available in JSON, LLM-friendly text, or both formats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 15,
   "maximum": 50,
   "minimum": 1
  },
  "format": {
   "enum": [
    "json",
    "llm",
    "both"
   ],
   "type": "string",
   "default": "json"
  },
  "category": {
   "enum": [
    "xstock",
    "prestock",
    "currency",
    "leverage",
    "solana",
    "collectible",
    "custom"
   ],
   "type": "string"
  },
  "quote_mint": {
   "type": "string",
   "maxLength": 44,
   "minLength": 32
  },
  "min_holders": {
   "type": "integer",
   "default": 25,
   "minimum": 0
  },
  "max_age_days": {
   "type": "number",
   "default": 14,
   "maximum": 90,
   "minimum": 0
  },
  "max_market_cap_usd": {
   "type": "number",
   "default": 5000000,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solenrich-stonkfun-gem-finder-80d8c4ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solenrich.com](https://www.zero.xyz/host/api.solenrich.com/llms.txt)
