An explorer API for Algorand. Accounts, assets, applications, transactions and rounds, served over algod + indexer.
Independent work under the BANKON License (Apache-2.0), part of the Open Blockchain Development Kit.
What is stable
The /api/v2 response shapes and the configuration surface. They will not change incompatibly without a major bump.
What this release does not claim
Stated plainly, because a version number is a promise and an inflated one is a lie: this is built, tested and published — not yet operated. It has never run under production traffic, has not been load-tested, and nothing consumes it in production yet. What is stable is the interface and the behaviour under test, not a track record.
Fidelity it refuses to compromise
An Algorand Standard Asset carries manager, reserve, freeze and clawback addresses. A clawback holder can move an asset out of your account without your signature — by design, for regulated instruments. Rendered as a generic token, that fact disappears. So the roles are always reported and a clawback transfer is named as one.
Likewise close-remainder (a payment can sweep the sender's entire balance to a third address; that amount never appears in amount, so both value and value_total are reported), inner transactions, atomic groups, rekeying, logic signatures, boxes, and finality.
Concepts Algorand does not have — gas, nonces, log topics, verified contract source, token allowances, reorgs — return null, never a substitute, each with a structural reason at /api/v2/capabilities.
Production surface
/livez (independent of the upstream — an indexer outage must not get the process killed) · /readyz (dependent on it — leave the rotation instead) · /metrics in Prometheus format with no Prometheus dependency · per-kind caching keyed to what the chain guarantees · checksum-validated inputs that reject a typo'd address locally · non-root container · CI on Python 3.10–3.12.
Read-only by construction. No signing key, no write route, and a test that fails if a write-shaped method ever appears.
Verification
185 tests, offline, against fixtures captured from live Algorand mainnet — not hand-written approximations. The assertions that matter most are the negative ones: that gas_used, nonce, abi and a round's own hash come back null rather than invented.
Every defect fixed before this release was found by probing the running service, not by re-reading code. See CHANGELOG.md for the full list.
docker build -t algorandscout . && docker run -p 8100:8100 algorandscout
curl localhost:8100/api/v2/capabilities