{"uid":"cap_DRikA8Ro0GL2zfQ8m5q4C","slug":"node-scorecard-api-top-nodes-endpoint-a0906f94","name":"Node Scorecard API – Top Nodes Endpoint","description":"Independent measurement and scoring of the Sentinel dVPN network. Pay per call in USDC over x402 — no account, no API key, no signup.","url":"https://nodescorecard.xyz/scorecard/nodes/top?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"n":{"type":"string","description":"How many nodes to return. Integer 1-50, default 5."},"country":{"type":"string","description":"Exact country name filter, case-insensitive, e.g. \"Germany\"."},"protocol":{"type":"string","description":"Protocol filter, case-insensitive: wireguard, v2ray, xray, hysteria2, amneziawg, openvpn."},"sla_only":{"enum":["true"],"type":"string","description":"Set to \"true\" to keep only nodes that passed the SLA speed test."},"min_score":{"type":"string","description":"Minimum composite score, 0-100. Default 0 (no filter)."},"max_per_asn":{"type":"string","description":"Max nodes allowed from the same ASN. Integer >= 1, default 2."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","description":"Real response to GET /scorecard/nodes/top?n=5, captured 2026-07-25T07:00:46Z. `matched` is how many nodes passed the filters before the top-N + ASN-diversity cut. `nodes` is truncated to the first 2 of the 5 returned; node objects are complete and verbatim."}}}}},"responseSchema":{"type":"json","example":{"count":5,"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}],"matched":1352,"network_active_total":1352}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YIYfEDS-Jx5efK4DGlpnT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the highest-scoring Sentinel dVPN nodes, filtered and ranked by composite quality score with ASN diversity controls.","exampleAgentPrompt":"Show me the top 10 Sentinel dVPN nodes in Germany that use WireGuard, passed the SLA speed test, and have a composite score of at least 75 — limit it to 2 nodes per ASN.","exampleUseCases":[{"title":"Picking best node for private browsing","prompt":"Find me the top 5 highest-scoring Sentinel dVPN nodes available right now, with SLA speed test passed and no more than 2 from the same network provider."},{"title":"Country-specific node selection","prompt":"I need the top 3 Sentinel dVPN nodes located in The Netherlands — show me ones that passed the SLA check so I know they're reliably fast."},{"title":"Protocol-filtered node discovery","prompt":"Give me up to 10 Sentinel nodes running the v2ray protocol with a composite score above 80, keeping ASN diversity to 1 node per provider."}],"resultDescription":"A JSON object with the total count of matched nodes, the network-wide active node total, and an array of top node objects each containing: composite score, uptime, reliability, SLA pass/fail and speed in Mbps, download/upload speeds, jurisdiction freedom score, censorship resistance level, residential flag, protocol, city, country, ASN, peers, leases, pricing per GB and per hour, and the node's Sentinel address and moniker.","failureModes":["Invalid or out-of-range 'n' parameter (must be integer 1–50) returns an error","Unrecognized protocol string returns empty or error response","Unrecognized country name returns zero matched nodes","Payment failure over x402 prevents response","Network unavailability of the scoring backend returns 5xx"],"whenToPreferThis":"Choose this endpoint when you need independently measured, scored, and ranked Sentinel dVPN nodes with rich metadata (speed, uptime, jurisdiction, ASN diversity) rather than raw on-chain node listings. It is the right choice when node quality, SLA compliance, or geographic/protocol filtering matters — especially for automated node selection in dVPN clients, monitoring pipelines, or research workflows. Prefer it over direct Sentinel chain queries when you need composite quality signals beyond simple availability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:35:31.348Z","isFirstParty":false,"canonicalSlug":"node-scorecard-api-top-nodes-endpoint-a0906f94"}