1. Announcements
TunnelSats Public Wireguard API
  • Announcements
    • 👋 About our team
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
    • How TunnelSats Leverages Public APIs for Confined VPN Management
  • 📡 Discovery
    • List Available WireGuard Servers & Regions
      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
  • 🔄 Lifecycle
    • Get Subscription & Bandwidth Status by WireGuard Public Key
      POST
    • Renew an Existing VPN Subscription (Anonymous)
      POST
    • Sync Subscription (Real-Time Server Refresh)
      POST
    • Request Bandwidth Top-Up ($1 for +100GB)
      POST
  • 🔑 Account
    • List Account Subscriptions (Authenticated)
      GET
  • 🔧 Tools
    • Lightning Node Network Address Discovery
      POST
    • Universal Connectivity & Latency Probe
      POST
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🚑 Node Health & Upkeep
    • ⚡ Bandwidth Top-Up ($1 for +100GB)
    • 🛡️ Security & Authentication
    • 🎁 Referral Program: Earn Bonus Months
    • 🛑 Error Codes & Troubleshooting
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • NodeLookup
    • ConnectivityResult
    • ApiError
    • ClaimResult
    • BandwidthResetResponse
    • PublicKeyStatusResponse
    • RenewalOrder
    • SubscriptionListItem
    • SyncResult
Tunnelsats Github
Tunnelsats Telegram
  1. Announcements

💫 What is TunnelSats?

TunnelSats provides pre-configured WireGuard VPN tunnels designed for Lightning Network nodes. It hides your node's IP, enables safe clearnet routing, and requires no KYC – just pay with Lightning.
This API enables developers to:
Programmatically provision VPN subscriptions for node operators.
Integrate VPN management into node management software (Umbrel, Start9, etc.).
Automate renewals for uninterrupted privacy.

🚀 API Capabilities#

⚡ Purchase Flow (No Auth Required)#

List available VPN servers (US, EU, Asia, Australia)
Create subscription → Lightning invoice
Claim WireGuard config after payment
Renew existing subscriptions

🔐 Account Management (API Key Required)#

List linked subscriptions
Sync real-time bandwidth/expiry from VPN servers
Manage referral codes & earn bonus months

⚡ Quick Start#

1
First Step
GET /servers → Pick a region
2
Second Step
POST /create → Get Lightning invoice
3
Third Step
Pay the invoice → Any Lightning wallet
4
Fourth Step
POST /claim → Receive WireGuard config
That's it – 4 API calls to private VPN! 🎉

🔐 Authentication#

Endpoint TypeAuth Required?Method
Purchase flow❌ NoNone – completely anonymous
Account endpoints✅ YesAuthorization: Bearer sk_live_...
How to authenticate:
1.
Get your API Key: Log in → Dashboard → Settings → Generate API Key
2.
Alternative: NIP-98 Nostr-signed events (for Nostr-native apps)

💰 Pricing#

DurationPriceDiscount
1 month$3.00-
3 months$8.555%
6 months$16.2010%
12 months$28.8020%
Prices converted to Sats at current BTC/USD rate.

🎁 Referral Program#

Include referralCode in /create for bonus months:
Plan PurchasedBonus Earned
3mo plan+1 month free
6mo plan+2 months free
12mo plan+3 months free

🌐 Base URL#

Production: https://tunnelsats.com
API Docs: https://api.tunnelsats.com
Modified at 2026-09-01 20:23:24
Previous
👋 About our team
Next
🚀 Introducing the TunnelSats Public API v1
Built with