TunnelSats Public Wireguard API
    • About our team
    • šŸ“¢ Public
      • List available VPN servers
        GET
      • Create a new VPN subscription
        POST
      • Claim a WireGuard configuration after payment
        POST
      • Check subscription status via payment hash
        GET
      • Renew an existing VPN subscription
        POST
      • Get Subscription Status
        POST
    • šŸ” Authenticated
      • Sync Subscription
        POST
      • Create Referral Code
        POST
      • Referral History
        GET
      • List all active/paid subscriptions for the account
        GET
    • Announcements
      • šŸ’« What is TunnelSats?
      • šŸš€ Introducing the TunnelSats Public API v1
      • How TunnelSats Leverages Public APIs for Confined VPN Management
    • Cookbook
      • šŸ› ļø Automation & Code Examples
      • šŸš Bash One-Liners
      • šŸ›‘ Error Codes & Troubleshooting
      • šŸŽ Referral Program: Earn Bonus Months
      • šŸš‘ Node Health & Upkeep
      • šŸ›”ļø Security & Authentication
    • Schemas
      • Server
      • InvoiceOrder
      • SubscriptionStatus
      • WireGuardConfig
      • ReferralCode
      • ReferralHistory
      • NodeLookup
      • ConnectivityResult
      • RenewalOrder
      • ClaimResult
      • ApiError
      • SubscriptionListItem

    About our team

    šŸ‘‹ Welcome to TunnelSats#

    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-02-24 13:54:23
    Next
    šŸ“¢ Public
    Built with