vermon API Documentation

Node version monitoring for blockchain networks

Purpose: This API tracks blockchain node versions across networks and IBP members. The runtime version indicates blockchain protocol compatibility - nodes with different runtime versions may not be compatible with the network.

Version Monitoring

GET /api/compare

Compare repository versions with on-chain versions for all networks. Shows version mismatches.

GET /api/compare/{network}

Compare versions for a specific network (e.g., polkadot, kusama, asset-hub-polkadot)

GET /api/networks

List all monitored networks with their version info. Use ?include_empty=true to include networks without data.

GET /api/networks/{network}

Get version information for a specific network

IBP Members

GET /api/members

List all IBP members with their node versions, certificate status, and latency

GET /api/members/{provider}

Get detailed information for a specific IBP member

Repository Info

GET /api/repos

List all monitored GitHub repositories and their latest release versions

GET /api/repos/{owner}/{name}

Get latest release info for a specific repository

Health & Stats

GET /api/health

System health status and uptime

GET /api/health-stats

Aggregated health statistics across all members (cert warnings, latency, unreachable nodes)

GET /api/stats

API usage statistics

GET /api/refresh

Trigger manual data refresh (rate limited to once per minute)

Response Examples

Version Comparison

{
  "network": "polkadot",
  "repository_version": "2024.09.1",
  "repository_tag": "polkadot-stable2509-1",
  "runtime_version": "1007001",
  "client_version": "1.20.1-bd19559e1fa",
  "matches": false,
  "last_checked": "2025-10-27T23:50:00Z"
}

Member Info

{
  "provider": "rotko",
  "services": [{
    "network": "polkadot",
    "ip": "prometheus",
    "runtime_version": "1007001",
    "client_version": "1.20.1-bd19559e1fa",
    "cert_days_left": 45,
    "latency_ms": 23
  }]
}

← Back to Dashboard