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

πŸš€ 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-02-11 22:59:09
Previous
πŸ’« What is TunnelSats?
Next
πŸ› οΈ Automation & Code Examples
Built with