Copy Page
TunnelSats Public Wireguard API
Announcements
👋 About our team
💫 What is TunnelSats?
🚀 Introducing the TunnelSats Public API v1
🧩 How the TunnelSats StartOS Package Uses the Public API
How TunnelSats Leverages Public APIs for Confined VPN Management
🤖 Autonomous Agent Payments (L402 & x402) & Level 5 Agent-Native Architecture
📡 Discovery
List Available WireGuard Servers & Regions
GET
L402 Agent Payment Gateway Discovery Metadata
GET
⚡ Purchase
Create a New WireGuard Subscription (Invoice Generation)
POST
Check Invoice Status & Polling by Payment Hash
GET
Claim WireGuard Configuration After Payment Settlement
POST
Autonomous Agent HTTP 402 Gateway (L402 Purchase + Claim)
POST
🔄 Lifecycle
Get Subscription & Bandwidth Status by WireGuard Public Key
Sync Subscription (Real-Time Server Refresh)
Renew an Existing VPN Subscription (Anonymous)
Request Bandwidth Top-Up ($1 Usage Reset)
🔑 Account
List Account Subscriptions (Authenticated)
Create Referral Code
Get Referral Code
Referral History
🔧 Tools
Lightning Node Network Address Discovery
Universal Connectivity & Latency Probe
Cookbook
🛠️ Automation & Code Examples
🐚 Bash One-Liners
🚑 Node Health & Upkeep
⚡ Bandwidth Top-Up ($1 Usage Reset)
🛡️ Security & Authentication
🎁 Referral Program: Earn Bonus Months