# Node Scorecard API – Sentinel dVPN Node Listings

> Node Scorecard API – Sentinel dVPN Node Listings is a paid API for AI agents from nodescorecard.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns independently measured performance scores and metadata for nodes on the Sentinel decentralized VPN network, with optional inclusion of inactive nodes.

## Facts

- Endpoint: GET https://nodescorecard.xyz/scorecard/nodes?utm_source=zero.xyz
- Price: $0.005/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-api-sentinel-dvpn-node-listings-4987aff2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gT4nV52ezBLu8NwSG3tAo

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-api-sentinel-dvpn-node-listings-4987aff2
```

Example prompt: Pull the current list of active Sentinel dVPN nodes from Node Scorecard and show me the top ones ranked by composite score, including their speed, uptime, price per GB, and whether they pass the SLA.

## When to prefer this

Use this endpoint when you need independent, third-party quality measurements of Sentinel dVPN nodes rather than self-reported node data. It is best suited for applications that need to select, rank, or monitor Sentinel nodes by objective performance criteria (speed, uptime, SLA, composite score, jurisdiction freedom). Prefer this over raw Sentinel network queries when composite scoring, censorship resistance assessment, or residential/ASN classification is needed. Its pay-per-call USDC model via x402 makes it ideal for agents that need on-demand access without API key management.

## Known failure modes

- Payment not processed — endpoint returns 402 if x402 USDC payment is missing or invalid
- Invalid query parameter value — passing a value other than '1' for the 'all' parameter may be ignored or cause unexpected behavior
- Network or upstream feed unavailability — the live feed from superpios/node-scorecard may be temporarily unavailable, causing a 503 or empty response
- Stale data — node metrics are sampled periodically, so very recently changed node states may not be reflected immediately

## 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 containing a count of matching nodes and an array of node objects, each with fields including: node address, moniker, city, country, ASN, protocol, peers, leases, uptime percentage, reliability score, composite score (0–100), SLA pass/fail, SLA Mbps threshold, download/upload speed in Mbps, price per GB and per hour, jurisdiction freedom score, censorship resistance level, residential flag, ASN saturation flag, ASN node count, ASN network share percentage, and API status. Also includes data source attribution and total active network count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "all": {
       "enum": [
        "1"
       ],
       "type": "string",
       "description": "Set to \"1\" to include every tracked node instead of only active ones. Omit for active only."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Real response captured 2026-07-25T07:00:46Z. `nodes` is truncated to the first 2 entries in this example; the live response returns `count` of them (1352 active at capture time, ~1813 with all=1). Node objects are complete and verbatim."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1352,
  "nodes": [
   {
    "asn": "AS8218 Zayo Infrastructure France SA",
    "city": "Vienna",
    "peers": 11,
    "leases": 1,
    "uptime": 96.6,
    "address": "sentnode1nmse5z50klakvwuy68w4wdgdvwzfasl8ryu9wk",
    "country": "Austria",
    "moniker": "SuchNode-3UK1BLjFTpZo",
    "samples": 590,
    "price_gb": 40.15,
    "price_hr": 50,
    "protocol": "v2ray",
    "sla_mbps": 45.89,
    "sla_pass": true,
    "protocols": null,
    "api_status": "ok",
    "reliability": 100,
    "residential": true,
    "asn_saturated": false,
    "speed_dl_mbps": 8.66,
    "speed_ul_mbps": 641.01,
    "asn_node_count": 2,
    "sla_percentile": 96,
    "composite_score": 92.2,
    "jurisdiction_freedom": 76,
    "asn_network_share_pct": 0.1,
    "censorship_resistance": "basic",
    "jurisdiction_freedom_estimated": false
   },
   {
    "asn": "AS206075 Hollander & Jacobsen UG (haftungsbeschraenkt)",
    "city": "Amsterdam",
    "peers": 6,
    "leases": 1,
    "uptime": 99.9,
    "address": "sentnode1rhjtstxhwdwfqmgkgd3yyf3hhzl7s4z5td44ln",
    "country": "The Netherlands",
    "moniker": "0_Premium_Service_100G_Nibiru2",
    "samples": 1027,
    "price_gb": 40.15,
    "price_hr": 50,
    "protocol": "v2ray",
    "sla_mbps": 56.38,
    "sla_pass": true,
    "protocols": null,
    "api_status": "ok",
    "reliability": 100,
    "residential": true,
    "asn_saturated": false,
    "speed_dl_mbps": 23.69,
    "speed_ul_mbps": 874.69,
    "asn_node_count": 2,
    "sla_percentile": 98,
    "composite_score": 91.8,
    "jurisdiction_freedom": 80,
    "asn_network_share_pct": 0.1,
    "censorship_resistance": "basic",
    "jurisdiction_freedom_estimated": false
   }
  ],
  "data_source": "superpios/node-scorecard live feed",
  "network_active_total": 1352
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/node-scorecard-api-sentinel-dvpn-node-listings-4987aff2/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)