monscope API

Free public endpoints for Monad validator data and decentralization metrics. JSON responses, no authentication. Cached server-side for 5 minutes. CORS-enabled. Please attribute monscope when displaying data publicly.

GET/api/v1/validators

Active consensus validator set ranked by stake, with name, share, commission, and social links.

Example

curl https://monscope.xyz/api/v1/validators

Response (truncated)

{
  "schema": "monscope.validators.v1",
  "fetched_at": "2026-05-23T22:43:48.752Z",
  "epoch": 1529,
  "active_set_size": 200,
  "active_set_cap": 200,
  "total_active_stake_mon": 15274612168.6,
  "validators": [
    {
      "id": 1,
      "rank": 1,
      "name": "Backpack",
      "stake_mon": 1842054041.93,
      "share_pct": 12.05,
      "commission_pct": 0,
      "website": "...",
      "x": "..."
    },
    ...
  ]
}

GET/api/v1/validators/{id}

Per-validator detail: stake, commission, top delegators with stake share, self-stake ratio, geographic / ASN attribution, identified Foundation contribution, position relative to BFT thresholds.

Example

curl https://monscope.xyz/api/v1/validators/3

Response (truncated)

{
  "schema": "monscope.validator.v1",
  "fetched_at": "2026-05-23T22:43:48.752Z",
  "validator": {
    "id": 3,
    "name": "gmonads.com",
    "auth_address": "0x...",
    "status": "ACTIVE",
    "rank_by_stake": 3,
    "stake_mon": 266846820,
    "stake_share_pct": 1.75,
    "commission_pct": 15,
    "delegators": { "total": 1247, "top": [...] },
    "geo": { "country": "United Kingdom", "asn": "AS...", ... },
    "foundation": { "stake_mon": 75000000, "share_pct": 99.7, "status": "identified" },
    "nakamoto": { "liveness": 23, "safety": 94, "inside_liveness_threshold": true }
  }
}

GET/api/v1/decentralization

Full decentralization snapshot: stake concentration (Nakamoto, Gini, HHI, top-N shares), commission distribution, active-set composition, geographic and infra concentration, Foundation share.

Example

curl https://monscope.xyz/api/v1/decentralization

Response (truncated)

{
  "schema": "monscope.decentralization.v1",
  "fetched_at": "2026-05-23T22:43:48.752Z",
  "epoch": 1529,
  "metrics": {
    "stake": { "totalStakeMON": ..., "nakamoto": { "liveness": 23, "safety": 94 }, ... },
    "commission": { "atVdpCap": 170, "buckets": [...], ... },
    "active_set": { "active": 200, "activeCap": 200, ... },
    "geo": { "uniqueCountries": 29, "countryNakamoto": 2, "countries": [...], ... }
  },
  "foundation": { "totalStakeMON": 11250000000, "foundationShareOfActiveStake": 74.03, ... },
  "top_validators": [...]
}

GET/api/v1/mips

MIP-adoption snapshot. Tracks MIP-2 deployed-code and initcode limit usage, MIP-4 static bytecode awareness plus sparse runtime trace samples, and MIP-5 CLZ / MODEXP methodology. Returns the latest weekly snapshot from the persistent tracking pipeline.

Example

curl https://monscope.xyz/api/v1/mips

Response (truncated)

{
  "schema": "monscope.mip-adoption.v2",
  "captured_at": "2026-06-14T05:35:06.401Z",
  "monad_nine_block": 62466234,
  "mip2": {
    "thresholdBytes": 24576,
    "initcodeLimitBytes": 49152,
    "totalContractsScanned": 25839,
    "contractsAboveThreshold": [ { "address": "0x...", "codeSize": 41280, ... } ],
    "initcode": { "contractsAboveLimit": 200, "contractsWithKnownSize": 200, ... },
    "lastProcessedBlock": 81162389,
    "methodology": { "deployedCodeSize": { "method": "exhaustive", ... }, ... }
  },
  "mip4": {
    "precompile": "0x0000000000000000000000000000000000001001",
    "selector": "0x3a61584e",
    "static": { "contractsScanned": 25839, "awareContracts": 4, ... },
    "runtime": { "sampleWindows": 0, "callsObserved": 0, ... },
    "methodology": { "static": { "method": "exhaustive", ... }, ... }
  },
  "mip5": {
    "clz": { "opcodeByte": 30, "contractsWithOpcode": 1662, ... },
    "modexp": { "precompile": "0x0000000000000000000000000000000000000005", ... },
    "methodology": { "clz": { "method": "exhaustive", ... }, ... }
  }
}

GET/api/v1/decentralization/history

Time-series of decentralization headline metrics from the snapshot archive. No params returns the compact series; ?from= / ?to= bound it; ?date=YYYY-MM-DD returns that day's full snapshot.

Example

curl https://monscope.xyz/api/v1/decentralization/history?from=2026-05-22

Response (truncated)

{
  "schema": "monscope.decentralization.history.v1",
  "fetched_at": "2026-06-01T00:35:00.000Z",
  "count": 11,
  "from": "2026-05-22",
  "to": "2026-06-01",
  "series": [
    {
      "date": "2026-06-01",
      "epoch": 1531,
      "nakamoto_liveness": 23,
      "nakamoto_safety": 94,
      "gini": 0.42,
      "hhi": 318,
      "top10_share_pct": 41.2,
      "active_validators": 200,
      "foundation_share_pct": 74.03,
      "majority_dependent": 188,
      "floor_vulnerable": 171
    },
    ...
  ]
}

GET/api/v1/foundation

The forensically identified Monad Foundation delegation fleet and its per-validator stake (the dataset behind the delegation map). ?format=graph returns the force-graph nodes/links; ?date=YYYY-MM-DD returns a historical breakdown.

Example

curl https://monscope.xyz/api/v1/foundation

Response (truncated)

{
  "schema": "monscope.foundation.v1",
  "provenance": { "methodology_version": "2026-06-01", "generated_at": "...", "sources": [...] },
  "snapshot_date": "2026-06-14",
  "distributor": "0xf12cea359512b8ccd5e7b33b3d308a174837250c",
  "fleet_hash": "sha256:...",
  "walletCount": 20,
  "totalMFStakeMON": 11225000000,
  "mfShareOfActivePct": 74.27,
  "validatorsReceiving": 196,
  "majorityDependentCount": 188,
  "floorVulnerableCount": 170,
  "perValidator": [ { "id": 1, "name": "...", "mfStakeMON": 75000000, "mfSharePct": 99.7, ... } ]
}

Notes

Server-side cache: 5 minutes (s-maxage=300, stale-while-revalidate=900).
CORS: Access-Control-Allow-Origin: *. Use from any origin.
Stake / commission / set membership are read live from the staking precompile at 0x0000000000000000000000000000000000001000.
Foundation share is identifiedfrom monscope's forensically attributed Foundation wallet fleet (EOAs funded by a common distributor, delegating in VDP tier amounts), not an official Foundation disclosure.
No rate limiting is enforced today, but please be polite: cache locally and don't poll faster than once a minute per endpoint.
Schema stability: the schema field (e.g. monscope.validators.v1) is a stable contract — additive fields may appear, but breaking changes ship under a new vN.
License: data is published under CC BY 4.0 — free to use with attribution to monscope (link back where practical).