Global Explorer API
Opt-in public share read API
The explorer publishes what a miner opted to publish, including their wallet address. Reads are one miner at a time: no endpoint, page, or feed returns a list of miners. It exposes no account records and offers no public profile-management actions.
Read a public share
GET/api/public-shares/{shareId}
A share ID is an opaque identifier supplied by a miner who enabled public sharing from the authenticated Melanin platform. Non-public, disabled, or unknown share IDs return 404.
{ "shareId": "share_…", "projectId": "btc", "observedAt": "2026-07-16T12:00:00.000Z", "metrics": { "hashrate1h": "0", "workerCount": 0, … }}Retired address endpoints
/api/users, /api/users/togglePrivacy, and /api/resetUser return 410 Gone. The old address URLs under /users/… are intentionally not served.
Private projection ingress
The write endpoint is an internal control-plane integration. It is disabled by default and requires a scoped HMAC client, replay-safe nonce, and production mTLS proxy identity. It is not a public API and no client secret belongs in browser code.
Per-address mining stats
Looking up one miner by wallet address is served by the Melanin gateway, not by this explorer: GET melanin.engineering/api/v1/miner/<address>. No key, no account, one address at a time.