TunnelSats Public Wireguard API
  1. Announcements
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List Servers
      GET
    • Create Subscription
      POST
    • Check Status / Heal
      GET
    • Claim Subscription
      POST
    • Renew Subscription
      POST
    • Get Subscription Status
      POST
  • 🔐 Authenticated
    • List My Subscriptions
      GET
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
  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-02-11 23:29:10
Previous
Referral History
Next
🚀 Introducing the TunnelSats Public API v1
Built with