Public API
Versioned JSON under /api/v1/monad. Same data powers the explorer — no raw IPs, deterministic tools where noted.
← Back to Developer HubBase URL
http://site-api:8770Rate limit ~120 req/min per IP. Responses include ETag and Cache-Control.
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/status | Dataset freshness, coverage and version stamps. |
| GET | /api/v1/monad/methodology | Machine-readable methodology document. |
| GET | /api/v1/monad/network | Core network intelligence object (NDI, SDS, health, graphs). |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/network/concentration | Decentralization metrics and concentration thresholds. |
| GET | /api/v1/monad/network/resilience | Failure simulation, dependency clusters and exposure graph. |
| GET | /api/v1/monad/network/flows?dimension=provider&window=7d | Stake flow leaderboards by dimension and window. |
| GET | /api/v1/monad/network/events?limit=50 | Operational change event feed. |
| GET | /api/v1/monad/network/anomalies | Confirmed and candidate infrastructure anomalies. |
| GET | /api/v1/monad/network/history | Legacy compat network history (prefer /history/*). |
| GET | /api/v1/monad/network/exposure | Country × provider × ASN exposure matrix. |
| GET | /api/v1/monad/network/observers | Multi-observer probe health (no IPs). |
| GET | /api/v1/monad/network/migrations?limit=30 | Recent validator infrastructure migrations. |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/history/network?days=90 | NDI / SDS / coverage time series. |
| GET | /api/v1/monad/history/concentration?days=90&weighting=stake | HHI and top-N concentration history. |
| GET | /api/v1/monad/history/events?limit=40 | History timeline with UI severity mapping. |
| GET | /api/v1/monad/history/validator/{validator_id}?days=90 | Per-validator infrastructure history. |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/gaps/summary | Gap explorer hero summary. |
| GET | /api/v1/monad/gaps/countries | Country representation gaps. |
| GET | /api/v1/monad/gaps/asns | ASN representation gaps. |
| GET | /api/v1/monad/gaps/providers | Provider representation gaps. |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/validators | Active validator list (safe fields). |
| GET | /api/v1/monad/validators/{validator_id} | Single validator profile. |
| GET | /api/v1/monad/validators/{validator_id}/migrations | Migration history for one validator. |
| POST | /api/v1/monad/validators/compare | Compare 2–3 validators (JSON body with ids). |
| GET | /api/v1/monad/entities/asn/{asn} | ASN entity intelligence. |
| GET | /api/v1/monad/entities/provider/{slug} | Provider entity intelligence. |
| GET | /api/v1/monad/entities/country/{code} | Country entity intelligence. |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/reports/weekly/latest | Latest structured weekly infrastructure report. |
| GET | /api/v1/monad/reports/weekly/{week} | Weekly report by week id (start_to_end filename). |
| Method | Path | Summary |
|---|---|---|
| GET | /api/v1/monad/tools/operator-economics/reference-rate | Illustrative gross staking reward reference (source + timestamp; not auto-bound). |
| GET | /api/v1/monad/tools/infrastructure-fit/options | Fit checker dropdown options and server catalog. |
| POST | /api/v1/monad/tools/infrastructure-fit | Infrastructure Fit Checker v1.0 (Susano estimate). |
| POST | /api/v1/monad/tools/scenario-lab | Scenario Lab — multi-node deployment impact. |
| POST | /api/v1/monad/tools/stress-simulate | Network Stress Lab — multi-entity failure simulation. |
Lightweight package susano-vi-sdk — optional fetch helpers for Node 18+ and browsers. Install from the monorepo packages/ folder.
npm install file:../packages/susano-vi-sdk
import { createViClient } from "susano-vi-sdk";
const vi = createViClient("http://site-api:8770");
const status = await vi.getStatus();
const weekly = await vi.getWeeklyLatest();