Public API

Validator Intelligence API

Versioned JSON під /api/v1/monad. Ті самі дані, що в explorer — без raw IP, детерміністичні tools де зазначено.

Base URL

http://site-api:8770

Rate limit ~120 req/min на IP. Відповіді з ETag і Cache-Control.

Core & methodology

Method	Path	Опис
GET	/api/v1/monad/status	Свіжість датасету, coverage і версії.
GET	/api/v1/monad/methodology	Машиночитана methodology.
GET	/api/v1/monad/network	Core network intelligence (NDI, SDS, health, graphs).

Network intelligence

Method	Path	Опис
GET	/api/v1/monad/network/concentration	Метрики децентралізації та concentration thresholds.
GET	/api/v1/monad/network/resilience	Failure simulation, dependency clusters і exposure graph.
GET	/api/v1/monad/network/flows?dimension=provider&window=7d	Stake flow leaderboards за dimension і window.
GET	/api/v1/monad/network/events?limit=50	Operational change event feed.
GET	/api/v1/monad/network/anomalies	Підтверджені та candidate infra anomalies.
GET	/api/v1/monad/network/history	Legacy compat network history (краще /history/*).
GET	/api/v1/monad/network/exposure	Exposure matrix Country × provider × ASN.
GET	/api/v1/monad/network/observers	Multi-observer probe health (без IP).
GET	/api/v1/monad/network/migrations?limit=30	Недавні infra migrations валідаторів.

History

Method	Path	Опис
GET	/api/v1/monad/history/network?days=90	Time series NDI / SDS / coverage.
GET	/api/v1/monad/history/concentration?days=90&weighting=stake	Історія HHI і top-N concentration.
GET	/api/v1/monad/history/events?limit=40	History timeline з UI severity.
GET	/api/v1/monad/history/validator/{validator_id}?days=90	Infra history окремого валідатора.

Gaps

Method	Path	Опис
GET	/api/v1/monad/gaps/summary	Hero summary gap explorer.
GET	/api/v1/monad/gaps/countries	Gaps представленості країн.
GET	/api/v1/monad/gaps/asns	Gaps представленості ASN.
GET	/api/v1/monad/gaps/providers	Gaps представленості провайдерів.

Entities & validators

Method	Path	Опис
GET	/api/v1/monad/validators	Список активних валідаторів (safe fields).
GET	/api/v1/monad/validators/{validator_id}	Профіль одного валідатора.
GET	/api/v1/monad/validators/{validator_id}/migrations	Історія migrations одного валідатора.
POST	/api/v1/monad/validators/compare	Порівняння 2–3 валідаторів (JSON body з ids).
GET	/api/v1/monad/entities/asn/{asn}	Intelligence сутності ASN.
GET	/api/v1/monad/entities/provider/{slug}	Intelligence сутності provider.
GET	/api/v1/monad/entities/country/{code}	Intelligence сутності country.

Reports

Method	Path	Опис
GET	/api/v1/monad/reports/weekly/latest	Останній structured weekly infra report.
GET	/api/v1/monad/reports/weekly/{week}	Weekly report за week id (start_to_end filename).

Tools (POST)

Method	Path	Опис
GET	/api/v1/monad/tools/operator-economics/reference-rate	Ілюстративний gross staking reference (source + timestamp; не auto-bind).
GET	/api/v1/monad/tools/infrastructure-fit/options	Опції Fit checker і 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.

TypeScript SDK (fetch wrappers)

Легкий пакет susano-vi-sdk — опційні fetch helpers для Node 18+ і браузера. Ставиться з monorepo packages/.

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();