DEVELOPERS / VERIFIED PUBLIC API

Build on the same data the observatory trusts.

Every endpoint below is served with multi-observer agreement (a quorum of separately run v30.1.3 observers on this deployment — process isolation, not independently operated infrastructure) and re-validated against an exact public schema before anything leaves this origin. Responses fail closed: if a record cannot be proven, you get an explicit unavailable envelope — never a guess, a zero, or a stale substitute presented as current. Coverage bounds are disclosed wherever an index is partial.

No authentication, no API keys. Please keep request rates neighborly (the origin enforces per-client limits). Amounts are canonical integer-sats strings; heights are exact; hashes are lowercase hex.

AI agents & MCP →Point any MCP-capable agent at the verified chain — one URL, no keys. Plus llms.txt.Keystone custody core →Turnkey deposit/withdrawal reference stack — docker compose up on regtest.Integration guide →Detect deposits, stream data — curl / JS / Python.Run a node →Per-OS install, blackcoin.conf, staking, pruning, systemd/docker, troubleshooting.Whitepaper →Protocol V4 spec: PQC, Gold Rush, migration, RPC & consensus reference.Chain params →Machine-readable ticker, decimals, HRP, phase heights, endpoints.OpenAPI →Full machine-readable API contract — import into Postman / Insomnia.API changelog →Version history + deprecation policy for the versioned contract (also /api/changelog.json).Verify it yourself →Reproduce every number on your own signed-source node.Brand & press kit →Logo assets, asset facts, palette, official links.Security & known issues →Private reporting, release boundaries, and current public P1 issues.

FOR EXCHANGES & CUSTODIANS / READ THIS FIRST

This is a read-only public telemetry and explorer API — not a custody integration API. It exposes verified chain and Protocol V4 accounting data for display and analytics. It does not create addresses, hold keys, track deposits, sign, or broadcast. To list or custody Blackcoin, run the signed-source v30.1.3 daemon (blackcoind) from the downloads rail against your own infrastructure and integrate via its JSON-RPC — that is the custody interface. Verify balances and history independently with the reproduction contract; the daemon is the source of truth, this API is a mirror of it.

Want a running reference to evaluate against? Blackcoin Keystone is a deposits-disabled custody core — a v30.1.3 node plus an adversarially hardened deposit/withdrawal daemon — that boots on regtest via docker compose up (tarball · sha256).

Listing applications: [email protected]
Technical & custody integration: [email protected]
General exchange contact: [email protected]

Integrate Blackcoin into your platform

CORS is open on every read endpoint. Fetch directly from any origin — no key, no proxy: fetch("https://projectblackcoin.org/api/v3/quantum").then(r => r.json())
Stream live state. new EventSource("https://projectblackcoin.org/api/v3/quantum/stream") pushes each verified snapshot the moment the quorum accepts it — the same feed that drives this site's block river and observatory.
Trust, then verify. Every response is already re-validated against the public schema before it leaves this origin, and the schema contracts ship in the site source — mirror the validation in your own client if your risk model wants a second check.
Run your own. The daemon itself carries the full explorer surface (txindex, shadowindex, getgoldrushblock, getshadowaddress and friends are enabled in the production build) — point the open-source release from the downloads rail at your infrastructure and you can serve this entire contract yourself.
Drop in the live badge. <script src="https://projectblackcoin.org/embed.js" async></script> renders a self-updating height + materialized-credits badge anywhere (add data-target="#css-selector" to control placement).
Machine-readable contract. The full surface is described in openapi.json; live health for every endpoint is at /status, and the reproduction contract lives at /verify.
Attribution welcome, not required. If you display this data, linking the exact record on this explorer (every response includes heights and hashes) lets your users verify it independently.

GET/api/v3/quantum

Current quorum-verified Gold Rush snapshot: anchor, shadow pools, next-block projections, source identity.

Quality ladder live / delayed / last_verified by snapshot age; strong ETag keyed on a content hash of public fields; 503 with {schema_version:3,status:"unavailable"} when no snapshot inside the one-hour retention window passes validation.

SSE/api/v3/quantum/stream

text/event-stream pushing each accepted snapshot as event: snapshot.

Event id is <height>:<snapshot_id>:<quality>; retry hint 5000 ms.

GET/api/v3/lifecycle

Quorum-attested schema-12 replay marker (with commitment hash), protocol phase, and the published consensus schedule.

GET/api/quantum

Legacy schema-2 snapshot envelope, preserved unchanged for existing consumers.

GET/api/releases

Validated release catalog from the signed GitHub record: platform-classified binaries and the verification rail (checksums, SBOM, provenance, evidence).

GET/api/supply

Base-chain supply sample (JSON: sats and decimal BLK). Plain-text aggregator endpoints: /api/supply/circulating and /api/supply/total.

SSE/api/explorer/stream

Server-sent events pushing each new verified block (event: block) with its base and shadow summary.

GET/explorer/address/{address}/feed.xml

Atom feed of an address's shadow payouts — watch any wallet from any RSS reader, no account needed.

GET/api/explorer/network

Live network telemetry: hashrate, difficulty, connections, mempool, chain size, and the observed peer-version mix (aggregate only — no peer addresses).

GET/api/explorer/status

Chain status plus per-index (tx, shadow, address) sync state and disclosed coverage bounds.

GET/api/explorer/recent-blocks?limit=1..50&before=<height>

Newest blocks with base and shadow summaries; `before` pages backward through history.

GET/api/explorer/block/{height|hash}?tx_offset&tx_limit

Full block record: header, paginated transactions, and every shadow event anchored to the block.

GET/api/explorer/tx/{txid}?vin_offset&vin_limit&vout_offset&vout_limit

Transaction with prevout-resolved inputs and spentness where provable; unknowables stay null, never guessed.

GET/api/explorer/address/{address}?offset&limit&shadow_offset&shadow_limit

Base-chain activity within disclosed coverage plus the complete synthetic payout history with independent pagination.

GET/api/explorer/shadow/tx/{synthetic_txid}

Synthetic payout record: lifecycle state, maturity, demurrage facts, spend linkage.

GET/api/explorer/shadow/supply

Anchored shadow supply: pools, materialized and phase-locked totals, claim counts.

GET/api/explorer/events

Recent shadow events (claims, distributions, signals) from the sanitized public stream.

GET/api/explorer/analytics/leaderboard?limit=1..100

Addresses ranked by materialized payouts, with PoW/PoS split and active range.

GET/api/explorer/analytics/series?from=<height>&to=<height>

Bucketed per-block series (payout value, event counts) for charting, capped at 240 points.

GET/api/explorer/search?q=<height|hash|txid|address>

Classifies a query and returns the exact explorer path for it.