API reference

Endpoints

• GET /health — all active coins, block height, online flag
• GET /network/{COIN}/current — latest network + pool snapshot (e.g. KOTO)
• GET /network/{COIN}/history?range=24h|7d|30d|all — time series for charts
• GET /network/{COIN}/pools — current pool stats
• GET /{coin}/status — blockchain + network summary for one coin
• POST /{coin}/rpc — JSON-RPC proxy (whitelisted methods only)
• POST /faucet/claim — KOTO gamified faucet claim (server must enable FAUCET_ENABLED)
• GET /faucet/status — per-activity availability for optional ?wallet=
• GET /faucet/balance — book balance + daily paid stats
• GET /faucet/recent — last paid claims (truncated addresses)

Coin slugs: yenten, koto, tidecoin.

GET /health

Quick check of every active node.

curl https://api.isekai-pool.com/api/v1/health

GET /{coin}/status

Returns fields such as blocks, difficulty, peers, progress, online, algo, symbol when the node is up. Use this from browsers — do not call raw node IPs from frontend code.

curl https://api.isekai-pool.com/api/v1/yenten/status

POST /{coin}/rpc

Body: {"method":"getblockcount","params":[]}. Only approved methods are allowed server-side.

curl -X POST https://api.isekai-pool.com/api/v1/yenten/rpc \
  -H "Content-Type: application/json" \
  -d '{"method":"getblockcount","params":[]}'

KOTO faucet (optional)

When the operator enables the faucet, POST /faucet/claim accepts JSON: wallet_address, activity_slug, turnstile_token (Cloudflare Turnstile). Optional header Idempotency-Key. Returns txid on success or a structured error. Disabled deployments respond with HTTP 503.

Whitelisted RPC methods

Including (not exhaustive — see server config for the canonical list):

getblockcount · getblockchaininfo · getnetworkinfo · getmempoolinfo · getblock · getblockhash · getrawtransaction · decoderawtransaction · sendrawtransaction · gettxoutsetinfo · getdifficulty · getconnectioncount