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

šŸ‘‹ About our team

TunnelSats is a Bitcoin-native VPN service built for privacy-conscious users and node runners. We accept only Bitcoin (Lightning Network via LNBits), require no email or personal information, and operate with a strict no-logs policy.

What We Do#

We provide WireGuard-based VPN subscriptions with:
šŸ”’ Privacy-first: Anonymous signup, Bitcoin-only payments
āš” Lightning-native: Instant payments, no KYC
šŸ› ļø API-first: Full programmatic access for automation
šŸŒ Decentralized: Built for the Bitcoin circular economy

Why We Built This API#

We believe automation and self-sovereignty go hand-in-hand. Node runners, developers, and privacy enthusiasts deserve:
Headless subscription management (no browser required)
Automated renewals via Nostr Wallet Connect (NWC)
Transparent pricing (always displayed in sats)
Full control through API keys and webhooks

Who Should Use This API?#

āœ… Node Operating Systems (RaspiBlitz, Umbrel, MyNode, Baremetal)
āœ… Lightning Network services needing VPN integrations
āœ… Privacy tools and automation scripts
āœ… Bitcoin developers building on circular economy infrastructure

Get Involved#

šŸ“¬ Integrations: If you're building a node OS or Bitcoin tool and want to collaborate, reach out via Telegram or Nostr
šŸ› Feedback: Found a bug? Missing a feature? We're listening
ā­ Community: Share your use cases, integrations, and automation stories
Stack: Next.js 16 (Turbopack), SQLite, WireGuard API, Lightning Labs & LNBits, Bitcoin-only!
Modified atĀ 2026-09-01 20:24:28
Next
šŸ’« What is TunnelSats?
Built with