# Node Scorecard Network Stats API

> Node Scorecard Network Stats API is a paid API for AI agents from nodescorecard.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns live aggregate statistics for the Sentinel decentralized VPN network, including node counts, speeds, protocols, geolocation, decentralization metrics, and pricing.

## Facts

- Endpoint: GET https://nodescorecard.xyz/scorecard/network-stats?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/node-scorecard-network-stats-api-3a8fe862
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OGsgKpv20x8fvVGXckhiO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability node-scorecard-network-stats-api-3a8fe862
```

Example prompt: Pull the latest Sentinel dVPN network stats — I want to see how many nodes are active, the median bandwidth score, pass rate, and how the network is spread across countries and ASNs right now.

## When to prefer this

Choose this endpoint when you need independent, third-party measurement of the Sentinel dVPN network rather than first-party Sentinel data. It is ideal for agents that require live, aggregated network health metrics — including speed SLAs, decentralization scores, and protocol distribution — without registration or API keys. Prefer it over scraping Sentinel's own dashboard when you need structured JSON output with statistical percentiles, or when building monitoring pipelines that need trustless pay-per-call access.

## Known failure modes

- Payment not received — returns 402 if USDC micropayment via x402 protocol is missing or malformed
- Network data unavailable — upstream live feed outage may return 503 or empty response
- Malformed response — if live feed schema changes, some fields may be missing or null
- Rate or payment processing errors — if x402 facilitator is unreachable, payment cannot be confirmed

## How this service works

Independent measurement and scoring of the Sentinel dVPN network. Pay per call in USDC over x402 — no account, no API key, no signup.

## Output

A JSON object with live Sentinel network metrics including: lease counts (nodes currently leased), totals (active, tracked, multi-protocol nodes), quality (SLA speed at p10/median/p90, pass rate, composite score), country distribution with share percentages, protocol breakdown (v2ray, WireGuard, etc.), residential node stats, decentralization data (ASN HHI index, top ASNs, unique ASN count), peer-to-peer pricing per GB (p10/median/p90), censorship resistance levels, and a UTC snapshot timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "leases": {
   "nodes_currently_leased": 552
  },
  "totals": {
   "active_nodes": 1352,
   "tracked_nodes": 1813,
   "multi_protocol_nodes": 0
  },
  "quality": {
   "sla_mbps_p10": 3.42,
   "sla_mbps_p90": 37.72,
   "sla_mbps_median": 12.01,
   "sla_tested_nodes": 1315,
   "sla_pass_rate_pct": 97.9,
   "composite_score_p90": 76.6,
   "composite_score_median": 59.9
  },
  "countries": [
   {
    "nodes": 456,
    "country": "United States",
    "share_pct": 33.7
   },
   {
    "nodes": 89,
    "country": "United Kingdom",
    "share_pct": 6.6
   },
   {
    "nodes": 88,
    "country": "Germany",
    "share_pct": 6.5
   }
  ],
  "protocols": [
   {
    "nodes": 724,
    "protocol": "v2ray",
    "share_pct": 53.6
   },
   {
    "nodes": 625,
    "protocol": "wireguard",
    "share_pct": 46.2
   },
   {
    "nodes": 1,
    "protocol": "xray",
    "share_pct": 0.1
   },
   {
    "nodes": 1,
    "protocol": "openvpn",
    "share_pct": 0.1
   },
   {
    "nodes": 1,
    "protocol": "hysteria2",
    "share_pct": 0.1
   }
  ],
  "data_source": "superpios/node-scorecard live feed",
  "residential": {
   "geoip_flag_only": 528,
   "verified_residential_pct": 11.8,
   "verified_residential_nodes": 159
  },
  "snapshot_ts": "2026-07-25T07:00:46Z",
  "decentralization": {
   "top_asns": [
    {
     "asn": "AS31898 Oracle Corporation",
     "nodes": 296,
     "share_pct": 21.9
    },
    {
     "asn": "AS36352 HostPapa",
     "nodes": 180,
     "share_pct": 13.3
    },
    {
     "asn": "AS8560 IONOS SE",
     "nodes": 145,
     "share_pct": 10.7
    }
   ],
   "hhi_index": 806,
   "unique_asns": 223,
   "saturated_asns": [
    {
     "asn": "AS31898 Oracle Corporation",
     "nodes": 296,
     "share_pct": 21.9
    },
    {
     "asn": "AS36352 HostPapa",
     "nodes": 180,
     "share_pct": 13.3
    },
    {
     "asn": "AS8560 IONOS SE",
     "nodes": 145,
     "share_pct": 10.7
    }
   ],
   "top3_asn_share_pct": 45.9
  },
  "pricing_p2p_per_gb": {
   "p10": 12.5,
   "p90": 41.5,
   "median": 40.15
  },
  "censorship_resistance": [
   {
    "level": "basic",
    "nodes": 724,
    "share_pct": 53.6
   },
   {
    "level": "minimal",
    "nodes": 626,
    "share_pct": 46.3
   },
   {
    "level": "high",
    "nodes": 1,
    "share_pct": 0.1
   },
   {
    "level": "medium",
    "nodes": 1,
    "share_pct": 0.1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/node-scorecard-network-stats-api-3a8fe862/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nodescorecard.xyz](https://www.zero.xyz/host/nodescorecard.xyz/llms.txt)