Reference

Endpoints

Public surfaces you can curl. Used for cross-verification, health probes, and light client reads.

Summary

Path	Method	Kind	Cache
`/api/health`	GET	JSON	60s
`/api/wallet/balance`	GET	JSON (proxy)	10s
`/.well-known/shain.json`	GET	JSON	5m
`/robots.txt`	GET	text	static
`/sitemap.xml`	GET	xml	static
`/manifest.webmanifest`	GET	JSON	static

/api/health

Runtime manifest. Cross-check against /.well-known/shain.json — the program field must agree.

curlbash

curl -s https://shain.fun/api/health | jq

responsejson

{
  "status": "ok",
  "name": "Shain",
  "description": "Shain is an anti-sniper holder membership on Solana. ...",
  "network": "solana-devnet",
  "stage": "pre-deployment",
  "program": "2T1Qs7f2hiy1sUQBWC7226xhXvCees97UfeqReRrnE66",
  "version": "0.1.0",
  "anchor": "1.0.0",
  "solana_cli": "3.1.13",
  "tests": { "passed": 9, "total": 9 },
  "repo": "https://github.com/shain-labs/shain-engine",
  "timestamp": "2026-04-23T00:00:00.000Z"
}

/api/wallet/balance

Server-side RPC proxy for balance reads. Useful when you want to read a wallet balance without pulling @solana/web3.js into a light client or a bot.

Query param	Required	Format
`address`	✓	base58 pubkey, 32–44 chars

curlbash

curl -s "https://shain.fun/api/wallet/balance?address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" | jq

response (success)json

{
  "ok": true,
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "lamports": 2406118312,
  "sol": 2.406118312,
  "slot": 339182441,
  "network": "solana-devnet"
}

response (error)json

{
  "ok": false,
  "error": "invalid address — must be a base58 pubkey"
}

/.well-known/shain.json

The cross-verify manifest. Bots and auditors read this first. Must agree with /api/health, the repo README, and the CLI's shain verify output.

curlbash

curl -s https://shain.fun/.well-known/shain.json | jq

responsejson

{
  "name": "shain",
  "description": "Anti-sniper holder membership on Solana. ...",
  "homepage": "https://shain.fun",
  "repository": "https://github.com/shain-labs/shain-engine",
  "stage": "pre-deployment",
  "deployment": { "devnet": "pending", "mainnet": "pending" },
  "program_id": "2T1Qs7f2hiy1sUQBWC7226xhXvCees97UfeqReRrnE66",
  "anchor": "1.0.0",
  "solana_cli": "3.1.13",
  "tests": { "passed": 9, "total": 9, "framework": "litesvm" }
}

Crawler files

/robots.txt — allow all user agents on / and /.well-known/; disallow /api/. AI bots (GPTBot, ClaudeBot, etc) are explicitly allowed.
/sitemap.xml — crawler entrypoint covering the home page, docs root, /api/health, and the well-known manifest.
/manifest.webmanifest — PWA manifest for iOS add-to-home and Android Chrome.