# StonkFun On-chain Data API

> Independent finalized Solana LaunchLab discovery, exact token/quote/pool markets and OHLCV. Partial coverage; quote-unit prices, unknown USD values are null. GeckoTerminal AMM candles and ingested swap candles. Free key from https://x4o2.com/keys or 0.001 USDC per call via x402 on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). No StonkFun website/API or Stonk Radar runtime dependency.

## Documentation

- [OpenAPI](https://stonkfun.x4o2.com/openapi.json): Machine-readable route definitions
- [Complete documentation](https://stonkfun.x4o2.com/llms-full.txt): Parameters, schemas and captured examples
- [API keys](https://x4o2.com/keys): Free access
- [30-day pass](https://x4o2.com/pass): Higher limits

## Access and limits

Free API key: https://x4o2.com/keys; Authorization: Bearer x4o2_… . Free access allows 60/minute and 1000/UTC day per service while spare capacity is available.
30-day pass: 10 USDC, 300/minute and 10000/UTC day per service, independent of free-tier pauses. POST https://x4o2.com/v1/pass with x402. Renewal extends from the later of expiry or purchase time. Wallet signing retrieves a replacement key at https://x4o2.com/pass; previous keys are revoked. Refunds are handled manually.
x402: request without payment to receive a v2 PAYMENT-REQUIRED challenge; sign one accepted Base or Solana USDC option, retry with PAYMENT-SIGNATURE. PAYMENT-RESPONSE contains the settlement receipt. Failed calls are not settled.
Counters reset on service restart. Pass expiry is enforced even when the key verifier is cached.
Errors: 400 invalid/unknown parameters; 401 invalid or expired key; 402 payment required or verification failed; 409 payment in flight/replayed; 429 minute_quota_exceeded, daily_quota_exceeded, free_tier_paused (Retry-After); 502 upstream error; 503 busy/unavailable. RateLimit-* and X-RateLimit-* describe key quotas.




## Endpoints

- [GET /v1/tokens](https://stonkfun.x4o2.com/v1/tokens): Observed token mints, paginated (0.001 USD via x402)

- [GET /v1/tokens/{mint}](https://stonkfun.x4o2.com/v1/tokens/{mint}): Exact token markets and freshness (0.001 USD via x402)

- [GET /v1/pairings](https://stonkfun.x4o2.com/v1/pairings): Quote mints verified in Stonk platform pools (0.001 USD via x402)

- [GET /v1/quotes](https://stonkfun.x4o2.com/v1/quotes): Alias of verified pairing quotes (0.001 USD via x402)

- [GET /v1/launches](https://stonkfun.x4o2.com/v1/launches): Recent verified LaunchLab pools; unknown creation times remain null (0.001 USD via x402)

- [GET /v1/markets](https://stonkfun.x4o2.com/v1/markets): Pools by exact token/quote and lifecycle (0.001 USD via x402)

- [GET /v1/tokens/{mint}/candles](https://stonkfun.x4o2.com/v1/tokens/{mint}/candles): Exact-market OHLCV in quote units; 1m through 1d (0.001 USD via x402)

- [GET /v1/trending](https://stonkfun.x4o2.com/v1/trending): 24h observed swap volume or fresh market cap within one quote mint (0.001 USD via x402)

- [GET /v1/leaderboard](https://stonkfun.x4o2.com/v1/leaderboard): Alias of quote-specific trending (0.001 USD via x402)

- [GET /v1/tokens/{mint}/holders](https://stonkfun.x4o2.com/v1/tokens/{mint}/holders): Owners of up to 20 largest token accounts; total wallet count unknown (0.001 USD via x402)

- [GET /v1/tokens/{mint}/burns](https://stonkfun.x4o2.com/v1/tokens/{mint}/burns): Observed SPL token burns; incomplete history (0.001 USD via x402)

- [GET /v1/payouts](https://stonkfun.x4o2.com/v1/payouts): Verified protocol claim transfers and fee accrual events (0.001 USD via x402)

- [GET /v1/rewards](https://stonkfun.x4o2.com/v1/rewards): Observed fee events; holder reward distributions unknown (0.001 USD via x402)

- [GET /v1/stats](https://stonkfun.x4o2.com/v1/stats): Protocol coverage, pool counts and ingestion freshness (0.001 USD via x402)