API Documentation & Sandbox | api-netstats.space

Interactive Testing Console

Live API Request Playground

Base URL: https://api-netstats.space

HTTP Method

Endpoint Path

HTTP Request Headers

Authorization: Bearer ns_live_9f8a371c20e94b0d88f12a3b

Content-Type: application/json

X-Telemetry-Format: protobuf+json

Simulated HTTP Response

HTTP 200 OK RTT: 1.42 ms

{
  "status": "success",
  "timestamp": "2026-07-29T08:24:54.102Z",
  "source_pop": "fra-01 (Frankfurt, DE)",
  "destination_pop": "iad-04 (Ashburn, VA)",
  "metrics": {
    "p50_latency_ms": 3.84,
    "p95_latency_ms": 18.21,
    "p99_latency_ms": 34.12,
    "packet_jitter_ms": 0.41,
    "ebpf_probe_count": 142,
    "bgp_as_path": [13335, 6939, 2914]
  },
  "rate_limit": {
    "remaining_quota": 9984,
    "reset_timestamp": 1785236700
  }
}

Authentication & mTLS Protocols

All requests to api-netstats.space require HTTP Bearer Token authentication or Mutual TLS (mTLS) for enterprise edge collectors. Pass your token via the standard header:

Authorization: Bearer ns_live_9f8a371c20e94b0d88f12a3b

// Secret API keys begin with ns_live_ or ns_test_

Rate Limiting & HTTP 429 Headers

The API enforces a token-bucket rate limiter evaluated per second. When quota is exceeded, the server returns HTTP 429 Too Many Requests with standard retry headers:

X-RateLimit-Limit 10000 req/min

X-RateLimit-Remaining 9984

Retry-After 2 seconds

SDK & Code Reference

curl -X GET "https://api-netstats.space/v1/telemetry/latency?src=fra-01&dst=iad-04" \
  -H "Authorization: Bearer ns_live_9f8a371c20e94b0d88f12a3b" \
  -H "Accept: application/json"