REST API

Endpoints for third-party integration

The 8mix API at https://api.8mix.gg provides endpoints for pool queries, transaction building, and relayer-assisted withdrawals. Third-party developers can integrate 8mix into their own applications.

Base URL: https://api.8mix.gg

Category	Endpoints	Description
Pools	/api/pools, /api/pools/:denom, /api/pools/:denom/root	Pool info, balance, Merkle root
Validation	/api/pools/:denom/check-spent, /api/pools/:denom/can-withdraw	Pre-withdrawal checks
Wallet	/api/balance/:address, /api/allowance/:address/:denom	USDT balance and allowance
Transactions	/api/tx/approve, /api/tx/deposit, /api/tx/withdraw	Build unsigned transactions
Relayer	/api/relayer/status, /api/relayer/withdraw	Gasless withdrawal via relayer

Quick example — check pool status:

curl https://api.8mix.gg/api/pools/100

{
  "ok": true,
  "data": {
    "denomination": 100,
    "address": "TEd3WceUmLB25bqygmk6zgZjhAYnSryTNc",
    "poolBalance": 100,
    "currentRoot": "0x27e7a9...",
    "relayerFee": 4
  }
}

Quick example — withdraw via relayer:

curl -X POST https://api.8mix.gg/api/relayer/withdraw \
  -H "Content-Type: application/json" \
  -d '{
    "denomination": "100",
    "proof": "0x...",
    "root": "0x...",
    "nullifierHash": "0x...",
    "recipient": "TRecipientAddress..."
  }'

{ "ok": true, "data": { "txid": "abc123..." } }

Rate limits: 120 requests/min (general), 5 requests/min (relayer).

Full API documentation with all endpoints, parameters, and error codes: API Reference