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.

API Documentation - Melanin Network Global Explorer