API reference

Endpoints

• GET /health — all active coins, block height, online flag
• GET /cpu-coins — CPU coin index JSON (chain + pool sample + CoinGecko); human page
• 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; when set, faucet_wallet is the transparent donation address from FAUCET_DONATION_ADDRESS (or legacy KOTO_FAUCET_WALLET) on the API — not the pool stratum wallet
• GET /faucet/recent — last paid claims (truncated addresses)
• GET /lucky-draw/status — pot, share counter, last winner, last_draw_event (skipped/failed reasons when a trigger ran but no payout) (LUCKY_DRAW_ENABLED)
• GET /lucky-draw/history — recent completed draws
• POST /lucky-draw/accumulate-pot — pool backend only; Bearer LUCKY_DRAW_INTERNAL_TOKEN; JSON block_reward_satoshis (required), optional block_height / block_hash for logs. Each add logs [LuckyDraw] with the configured pot % (default 0.5%).

Coin slugs: yenten, koto, tidecoin.

GET /health

Quick check of every active node.

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

GET /cpu-coins

Aggregated snapshot for the CPU mining index page. Cached ~5 minutes. Includes Isekai node getmininginfo where configured, optional pool API samples, and CoinGecko price fields.

curl https://api.isekai-pool.com/api/v1/cpu-coins

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.

KOTO pool lucky draw (optional)

Public read endpoints return HTTP 503 when disabled. Human-friendly dashboard: KOTO lucky draw.

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

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