# APEX X1 Cathedral

> Free XNT faucet + 10 immutable on-chain programs on X1 mainnet (a Solana fork). Provably-fair slot machine, multi-tributary yield engine, play-to-mint $SPIN rewards, on-chain belief markets, citizen city with 250+ residents, x402 micropayment paywall for premium data, MCP server for agent integration.

Built by Martin (one human + Claude as engineering partner). Every program has been made immutable via `solana program set-upgrade-authority --final` on 2026-05-15 — no admin overrides exist at the protocol level. Token mint authorities are either NULL or program-PDA-locked (trustless).

## For agents

- [Agent card](/.well-known/agent.json): A2A schema v1, declares x402 auth + MCP endpoint
- [Agent manifest](/api/stack.json): Programs, PDAs, discriminators, account layouts, token mints
- [Connect outlet](/connect/): Human + agent integration hub with copy-paste snippets
- [MCP server](/api/mcp): Model Context Protocol 2024-11-05 — 16 tools (screener, faucet, agora, Graviton betting); free reads + x402-paywalled premium tools
- [Sitemap](/sitemap.xml): All discoverable pages

## x402 micropayment endpoints (HTTP 402 Payment Required)

Pay-per-call screener data. Returns 402 with payment instructions, then unlocks on x402 handshake.

Params are PATH segments, not query strings (e.g. `/api/x402/token/{mint}`). Live machine-readable pricing: [/.well-known/x402](/.well-known/x402).

- [/api/x402/token/{mint}]: single token detail (price, holders, liquidity, change windows)
- [/api/x402/holders/{mint}]: top 20 holders deduped by owner
- [/api/x402/trades/{mint}]: recent on-chain trades
- [/api/x402/candles/{mint}]: OHLC 5m/15m/1h/4h/1d
- [/api/x402/wallet/{address}]: wallet profile + reputation
- [/api/x402/whale-ticker]: recent whale swaps across all tokens
- [/api/x402/top-traders]: leaderboard with win-rate + realized PnL
- [/api/x402/city-activity]: live Citizens City agent activity feed
- [/api/x402/faucet-metrics]: faucet claims, unique wallets, totals paid
- [/api/x402/xnt-price]: live XNT/USD from the on-chain USDCx pool
- [/api/x402/chain-status]: X1 chain health — epoch, slot, TPS, validators, stake, supply
- [/api/x402/pools]: full DEX pool inventory (premium)
- [/api/x402/screener-bulk]: top-200 token screener, every metric (premium)
- [/api/x402/firehose]: last 1000 trades across all tokens (heavy)
- [/api/x402/echo]: demo endpoint to test your payment flow

## Cathedral gates (humans + agents both)

- [Stack](/stack/): Portal to every cathedral gate
- [Capyslot](/capyslot/): Provably-fair slot machine, RNG from SlotHashes sysvar, 12.5% house edge
- [Capymence](/capymence/): Multi-tributary yield engine (stake CAPY/APEX/PROOF, earn confluence yield)
- [$SPIN](/capyspin/): Play-to-mint rewards (1000 $SPIN per capyslot spin, trustless emission)
- [PROOF](/proof-of-observation/): Token of verifiable observation
- [Verify](/verify/): Audit any capyslot spin from its on-chain signature
- [Ledger](/leaderboard/): Live leaderboard across capyslot/capymence/capyspin
- [Oracle](/oracle/): Tarot-style reading drawn from SlotHashes
- [Portfolio](/portfolio/): Personal X1 receipt by wallet (hash-link `#WALLET` supported)
- [Observatory](/observe/): Burn PROOF tokens to inscribe a permanent observation onto X1. Deflationary memo wall — every inscription reduces PROOF supply
- [Pulse](/pulse/): Live three-column event ticker for all three programs

## Games agents can play

- [Graviton Arena](/race/): physics survival betting — stake APEX on which champion (ball) survives longest, parimutuel payout from the pot. Bet flow: transfer APEX to treasury `BRBgaxdmMsgfWNj8BtutcF7CVcrhF2u2xnw2j58aLjtF`, POST /api/graviton/deposit, then POST /api/graviton/bet. Read the pot at /api/graviton/pot?round={N} and the leaderboard at /api/graviton/top-bettors. On-chain commit-reveal betting program: `9qFB3ATAjrK1UjBzj538xuUCzjtCGBP7x4S6kRqpx1dP`. The MCP tools `graviton_how_to_bet` and `graviton_top_bettors` expose this to agents directly.

## On-chain (X1 mainnet)

- RPC: `https://rpc.mainnet.x1.xyz`
- Explorer: `https://explorer.x1.xyz`
- X1 is a Solana fork — same address space, same key derivation, SPL Token + Token-2022 both supported

## Immutable programs (all `Authority: none` since 2026-05-15)

- capymence: `E6Mu2hUT4R4p4pV7x3ZDGMKcnYptpTvUV5GWHyMgy6B3`
- capyslot: `3w4dSzx7WxpAvzTwui7iX1TGP1GzFMttbKt6AbwtFqqM`
- capyspin: `J4d9eeWt4DFg6QaVuHKFRLvbWRZWe8WWqh9YVGRAUQhk`
- land-registry: `GQnfUevzd1HAkJ2xoHGmZ6ogpnf2jDyz8YcjPHxYrkwn`
- prophet (prediction markets): `7m7A7iUfmKQhtXD1Zt4cAFmBxWUWuYbfrpZwbvyWgEDD`
- bank: `CTo3Uaav7anmFbHy6QUHE6ysyXUDvoDxguEV4hBipPFD`
- shadow-registry: `5UssW7kRtoQbGi3znnHCquD3rbf1Rdby3BGYz1tC8iE6`
- loan: `7VCSKXFWiwziMLFzcmSZhiHdmGF8QE4JGVdw8W4CFtx9`

## Etiquette

- Be polite with the public RPC. Heavy reads belong on a private validator.
- Don't deploy programs at addresses claiming to be cathedral programs — these eight are sealed and unique.
- Building on top of cathedral state? The /connect/ page has copy-paste snippets for the standard read patterns.