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

🚀 Introducing the TunnelSats Public API v1

We're excited to announce the official launch of the TunnelSats Public API - a complete programmatic interface for managing Bitcoin VPN subscriptions without touching a browser.

What's New?#

Our API provides full lifecycle management for WireGuard VPN subscriptions:
✅ Create subscriptions with Bitcoin Lightning payments
✅ Renew automatically using Nostr Wallet Connect (NWC)
✅ Monitor data usage and bandwidth limits
✅ List active subscriptions across all your configs
✅ Sync WireGuard keys to your server infrastructure
All endpoints return machine-readable JSON, support API key authentication, and respect rate limiting for fair usage.

Why We Built This#

We saw node runners and Bitcoin enthusiasts managing VPN subscriptions manually—copy-pasting config files, setting calendar reminders for renewals, and juggling multiple services. That's not sovereign.
📌
Privacy and automation shouldn't conflict.
With this API, you can:
Automate renewals via NWC and cron jobs
Integrate VPN provisioning into node management UIs
Build privacy-first tools on top of Bitcoin infrastructure
Run headless setups without ever opening a web browser

Who Should Use This?#

Node Operating Systems#

RaspiBlitz, Umbrel, MyNode, Start9, and others: We'd love to collaborate on app store integrations. Imagine one-click VPN provisioning for your users, paid in sats, with zero personal data collection.

Node Runners & Developers#

If you're building:
Lightning node automation tools
Privacy-focused applications
Bitcoin circular economy services
WireGuard management dashboards
...this API is for you.

What We Need From You#

🛠️ Feedback: What's missing? What's clunky? Tell us.
🔌 Integrations: Share your use cases and let's build together.
⭐ Stars: If you find this useful, spread the word in the Bitcoin community.

Get Started#

📖 Documentation: API reference
🔑 API Keys: Generate yours at tunnelsats.com/dashboard
But you can already lean in:
💬 Community: Join our Telegram to discuss integrations

The Vision#

We're building infrastructure for a Bitcoin-native internet—where privacy, Lightning payments, and open APIs are default, not opt-in.
If you're working on node software, privacy tools, or Lightning integrations, let's talk. We're open to partnerships, co-development, and community-driven features.
📌
Need Code Examples? > Stuck on a specific flow? We are happy to provide example scripts (Python, Go, Node.js) to help you get your automation logic running in minutes.

What We Are Looking For:#

Programmatic Growth: We are looking for partners to help grow VPN infrastructure for Lightning Node runners. If you are building a Node OS or a management dashboard, let’s talk about deep integrations.
Use-Cases & Feedback: Whether you are building an auto-renewal bot via NWC or a headless server provisioning tool, we want to hear your story. Your feedback directly shapes our v2 roadmap.
🕊️ Transparency: Check our warrant canary - we've received zero government requests for user data.
⚡ Built for Bitcoiners. Powered by Lightning. Programmatic by Default.
Modified at 2026-09-01 20:37:17
Previous
💫 What is TunnelSats?
Next
How TunnelSats Leverages Public APIs for Confined VPN Management
Built with