PUBLIC / READ-ONLY API
Rewards,
by address.
No API key or wallet signature required. Anyone can look up a mining address. These endpoints expose pool accounting, not a wallet balance or a promise of future rewards.
Endpoints
- GET /api/pool — pool totals and recent blocks.
GET /api/rewards?address=YOUR_OAG_ADDRESS— rewards and estimated hashrate for one mainnet address.- GET /api/payouts — the latest ten pool-wide payout transactions, with confirmation status.
- GET /api/network — observations from the upstream explorer.
Look up your rewards
Enter your public receiving address.
Example
curl --get 'https://orange.gen.nz/api/rewards' \ --data-urlencode 'address=YOUR_OAG_ADDRESS'
Reading the response
- immature_oag
- Your allocated share of rewards awaiting maturity. Reorganizations can remove rewards.
- unpaid_oag
- Mature pool balance waiting for a payout. The minimum is 1 OAG; the pool checks every ten minutes.
- paid_recorded_oag
- Cumulative pool accounting amount before payout transaction fees. Includes submitted payments that may not yet be confirmed. It is not your wallet balance.
- Amounts
- OAG amounts are decimal strings with up to 16 fractional digits. Use decimal arithmetic, not binary floating-point, when accounting for coins.
- Freshness
- Pool data updates about once a minute while the operator’s publisher is online. observed_at is the observation time. stale becomes true after three minutes without an update. A stale response still contains historical data; do not treat it as current.
- Status codes
- 200: observation available. 400: invalid or missing address. 404: valid address absent from this snapshot (not a claim of zero balance). 503: observations unavailable.
The rewards and payouts responses use schema_version 1. Cross-origin GET requests are allowed. Please poll no more than once a minute per address. Worker names, IP addresses and private keys are not included. The payout list is pool-wide and limited to ten recent transactions; inspect the linked explorer transactions for actual outputs and fees.