Zum Hauptinhalt springen
Windscribe

Die VPN-APIfür deineDie VPN-APIfür deine Agenten.

Gib deinen KI-Agenten ihr eigenes WireGuard-VPN. Sie kaufen es mit USDC in einem einzigen API-Aufruf, blockieren schädliche Domains per DNS-Filterung und brauchen nie ein Konto.

Agenten: Startet bei llms.txt. Basis-URL https://api.windscribe.com/vpn

Anwendungsfälle

Was Agenten mit ihrem eigenen VPN machen

Agenten handeln für dich im offenen Web. Bei diesen Aufgaben kommt es auf eine private, steuerbare Verbindung an.

  • Datenschutz

    Privat surfen

    Websites sehen eine Windscribe-IP, nie dein Heim- oder Büronetzwerk.

  • Geo-Tests

    Ein anderes Land sehen

    Prüfe lokale Preise und Suchergebnisse so, wie die Menschen vor Ort sie sehen.

  • Sicherheit

    Jedes Netzwerk absichern

    Hotel-WLAN, Roboter und Edge-Geräte erhalten einen verschlüsselten WireGuard-Tunnel.

  • Plattformen

    Ein Tunnel pro Kunde

    Ein Schlüssel und eine Laufzeit pro Workspace oder Job. Keine Konten zu verwalten.

DNS-Filterung mit ROBERT

Bestimme, was dein Agent erreichen kann

Blockiere Malware- und Phishing-Domains, damit ein Agent nicht dorthin gelenkt werden kann, oder entferne Werbung und Tracker, um Ballast und Datenverbrauch zu reduzieren. Eine einzige API-Anfrage wechselt die Listen für einen Schlüssel, und der DNS-Resolver des Tunnels setzt sie durch.

Filterlisten
DNS-Abfragen3 von 9 blockiert
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.exampleWerbung + TrackerBLOCKIERT
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.exampleSchadsoftwareBLOCKIERT
  8. ads.network.exampleWerbung + TrackerBLOCKIERT
  9. cdn.images.example

PUT /vpn/wireguard/settings{"robert": ["malware","ads"]}→ wireguard.dns = 10.255.255.3

Leitplanken für autonome Agenten

Ein Agent, der einem schädlichen Link oder einer eingeschleusten Anweisung folgt, kann bekannte Malware-, Phishing- oder Botnet-Domains trotzdem nicht auflösen.

Weniger Daten, weniger Ballast

Das Blockieren von Werbung und Trackern macht Seiten schlanker, sodass Agenten weniger Tokens und Bandbreite für Überflüssiges verbrauchen.

Pro Schlüssel per API festlegen

Neue Schlüssel starten mit aktivierter Malware-Blockierung. Listen jederzeit ändern mit:

PUT /vpn/wireguard/settings

Datenschutz und Kontrolle

Keine Registrierung, nichts, was durchsickern kann

Identität

Null Konten

Die API fragt nie, wer du bist. Dein Agent erzeugt ein WireGuard-Schlüsselpaar, und der öffentliche Schlüssel ist die gesamte Identität. Der private Schlüssel verlässt nie die Maschine, und jede Anfrage, die die Verbindung verwaltet, wird damit signiert – halte ihn also so privat wie die Verbindung selbst.

E-MailPasswortKarteSitzungwg_pubkey ✓
x402-Zahlungen

Dein Agent bezahlt selbst

USDC auf Base, pro Anfrage abgewickelt über den offenen x402-Standard. Keine Checkout-Seite, keine hinterlegte Karte, und eine wiederholte Zahlung wird nie doppelt abgebucht.

Standard-WireGuard

Funktioniert mit jedem WireGuard-Client

Eine mit deinem Schlüssel signierte Anfrage liefert Adresse, DNS-Resolver und Pre-Shared Key, sodass für eine wg-quick-Konfiguration eine einzige Vorlage genügt.

Volle Kontrolle per API

Zugang verlängern, übertragen oder beenden

Kaufe mehr Zeit, übertrage den Zugang auf einen neuen Schlüssel oder widerrufe ihn sofort – jeweils mit einer einzigen signierten Anfrage.

So kauft ein Agent ein VPN mit x402

Vom Nichts zum Tunnel in vier Schritten

Einfaches HTTP und der offene Zahlungsstandard x402. Jeder x402-v2-Client kann ohne eigenen Code bezahlen.

  1. 402

    Laufzeit anfragen

    Sende einen öffentlichen WireGuard-Schlüssel und eine Anzahl von Monaten. Die Antwort enthält den genauen Preis, das Netzwerk und den Zahlungsempfänger.

    POST /vpn/wireguard

  2. x402

    Angebot bezahlen

    Signiere eine USDC-Überweisungsautorisierung und sende dieselbe Anfrage damit erneut.

    PAYMENT-SIGNATURE: …

  3. 201

    Konfiguration erstellen

    Eine signierte Anfrage liefert Adresse, DNS-Resolver und Pre-Shared Key. Wähle einen Ausgang aus der Standortliste.

    GET /vpn/wireguard/locations

  4. WG

    Verbinden

    Baue den Tunnel mit einem beliebigen WireGuard-Client auf und setze die Filter, die die Aufgabe braucht.

    wg-quick up ./windscribe.conf

Preise

Ein Preis, bezahlt in USDC

Bezahlt in USDC auf Base mit x402. Kein Abo und keine automatische Verlängerung: Kaufe mit demselben Schlüssel erneut, um Zeit hinzuzufügen, bis zu 12 Monate im Voraus. Zahlungen sind endgültig.

Monatlich0 $
JährlichSpare 39 $0 $

Doku für Entwickler und Agenten

Alles, was ein Agent zum Start braucht

Die OpenAPI-Spezifikation beschreibt jeden Endpunkt. llms.txt ist die Kurzfassung für Agenten.

Gib das deinem Agenten
Lies https://windscribe.com/vpn-api/llms.txt.
Erstelle auf diesem Rechner ein WireGuard-Schlüsselpaar, kaufe dafür mit x402 einen Monat Windscribe-VPN-Zugang, aktiviere die Blockierung von Malware und Werbung und schreibe dann eine wg-quick-Konfiguration für den nächstgelegenen Standort. Behalte den privaten Schlüssel auf diesem Rechner.
Auf einen Blick
Basis-URL
https://api.windscribe.com/vpn
Erkennung
GET /vpn
Zahlung
x402 v2, exact-Schema, USDC auf Base
Authentifizierung
Anfragen signiert mit dem WireGuard-Schlüssel (wg-xeddsa-v1)
Die API erkunden9 Endpunkte, Anfrage- und Antwortfelder, Code in cURL, Python und JavaScriptÖffnen
POST/vpn/wireguard

Buy time for a WireGuard key

Creates a new entitlement, extends an active or expired one from max(now, expires), or reactivates a revoked one with a fresh PSK and a term starting now. Send without PAYMENT-SIGNATURE for an x402 quote, then retry the identical body with PAYMENT-SIGNATURE. A wg-xeddsa-v1 signature by the key in the body is optional; when sent it must verify, and a signed quote also checks that the key can buy the term now. The response carries `psk` only when the request is signed by the key: anyone can pay for any key. Retrying the same PAYMENT-SIGNATURE never pays twice.

Signatur optionalx402 · USDC auf BasebuyWireGuardTime

Header

Header-Name
Erforderlich
Beschreibung
PAYMENT-SIGNATURE
nein
Base64 x402 v2 PaymentPayload. Omit to receive a quote. Its authorization's validBefore must be at most maxTimeoutSeconds, plus 30 seconds of clock skew, from now.
X-Windscribe-WireGuard-Key
nein
Part of the optional purchase signature.
Content-Digest
nein
Part of the optional purchase signature.
Signature-Input
nein
Part of the optional purchase signature.
Signature
nein
Part of the optional purchase signature.

Anfragetext · application/json

Feld
Typ
Beschreibung
wg_pubkeyerforderlich
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
monthserforderlich
integer
123456712

Antworten

Payment settled and time bought

Feld
Typ
Beschreibung
pubkeyerforderlich
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
statuserforderlich
string
activeexpiredrevoked
expireserforderlich
integer
Unix seconds; access ends exactly then.
ipv4erforderlich
string
ipv6erforderlich
string
roberterforderlich
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguarderforderlich
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.addresserforderlich
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6erforderlich
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dnserforderlich
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ipserforderlich
"0.0.0.0/0, ::/0"
wireguard.endpoint_porterforderlich
443
purchasable_termserforderlich
integer[]
Terms that a purchase would accept now without exceeding the 12-month cap.
123456712
psk
string
WireGuard preshared key for the [Peer] section. Only when the request is signed by the key; otherwise read it with a signed GET /vpn/wireguard.
successerforderlich
1
payment_iderforderlich
string | null
Null when rotate moved an active entitlement.
settlement_referenceerforderlich
string | null
Base transaction hash of the settlement.

Die angezeigten Felder liegen innerhalb von data.

Anfrage
# 1. Quote. The x402 PaymentRequired object is in the PAYMENT-REQUIRED header (base64).
curl -si https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'

# 2. Pay with any x402 v2 client, or build the payload as in the Python tab,
#    then send the same request with the payment.
curl -s https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -H "PAYMENT-SIGNATURE: $PAYMENT" \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'
Beispielantwort · 201
{
  "data": {
    "pubkey": "j0DFrbaPJWJK5bIU6nZ6bslNgp09e14a0bpvPiE4KF8=",
    "status": "active",
    "expires": 1797207705,
    "ipv4": "100.88.12.34",
    "ipv6": "fd54:4::5c0c:2a2",
    "robert": [
      "malware"
    ],
    "wireguard": {
      "address": "100.88.12.34/32",
      "address_v6": "fd54:4::5c0c:2a2/128",
      "dns": "10.255.255.2",
      "allowed_ips": "0.0.0.0/0, ::/0",
      "endpoint_port": 443
    },
    "purchasable_terms": [
      1,
      2,
      3,
      4,
      5,
      6,
      7
    ],
    "psk": "EXAMPLEexampleEXAMPLEexampleEXAMPLEexample0=",
    "success": 1,
    "payment_id": "6c1f0e9a2b7d4c3e8f5a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e",
    "settlement_reference": "0xeb0c71793e4e18a80c8123e34c8f908404f4ee107d3c8dfea4c742ad73e01ccf"
  }
}
All Your Devices
Stars

Gib deinen Agenten ihr eigenes VPN.

Angebot mit POST /vpn/wireguard, bezahlen mit x402, verbinden mit WireGuard.

All Your Devices

Fragen

Bevor du kaufst

Was ist die Windscribe VPN-API?

Eine HTTP-API, die Zugang zum Windscribe WireGuard VPN direkt an einen öffentlichen WireGuard-Schlüssel verkauft. KI-Agenten, Skripte und Geräte können eine Verbindung ohne Windscribe-Konto kaufen, nutzen und verwalten.

Kann ein KI-Agent selbstständig ein VPN kaufen?

Ja. Der Agent sendet seinen öffentlichen WireGuard-Schlüssel und eine Laufzeit, erhält ein HTTP-402-Angebot, bezahlt es in USDC mit x402 und bekommt die Werte für eine WireGuard-Konfiguration zurück. Niemand muss sich registrieren oder etwas bestätigen.

Brauche ich ein Windscribe-Konto?

Nein. Die API fragt nie nach E-Mail, Passwort oder Sitzung. Dein öffentlicher WireGuard-Schlüssel identifiziert den Kauf, und Anfragen, die ihn verwalten, werden mit dem passenden privaten Schlüssel signiert.

Wie bezahle ich?

Mit USDC auf Base, über x402 v2. Die erste Anfrage liefert den genauen Betrag und die Empfangsadresse; dein Client signiert eine Autorisierung für eine USDC-Überweisung und sendet die Anfrage erneut.

Ist das ein Abo?

Nein. Jede Zahlung kauft eine feste Laufzeit von 1 bis 7 oder 12 Monaten. Kaufe mit demselben Schlüssel erneut, um Zeit hinzuzufügen, bis zu 12 Monate im Voraus.

Kann ich eine Rückerstattung bekommen?

Nein. Zahlungen sind endgültig. Das Widerrufen eines Schlüssels beendet den Zugang sofort, und die verbleibende Zeit verfällt; ein erneuter Kauf von Zeit reaktiviert den Schlüssel.

Kann ich steuern, welche Domains mein Agent erreichen kann?

Ja. Jeder Schlüssel hat ROBERT-DNS-Filterlisten: Schadsoftware (einschließlich Phishing- und Botnet-Servern), Werbung + Tracker, Soziale Netzwerke, Pornografie, Glücksspiel, Clickbait-Seiten, Krypto und Andere VPNs. Neue Schlüssel starten mit aktivierter Schadsoftware-Liste, und PUT /vpn/wireguard/settings ändert die Listen jederzeit. Eigene Domain-Regeln werden nicht unterstützt.

Welches VPN-Protokoll wird verwendet?

WireGuard. Die API liefert Interface-Adresse, DNS-Resolver, Pre-Shared Key und Endpunkt-Port, sodass sich jeder WireGuard-Client, einschließlich wg-quick, verbinden kann.

Was speichert Windscribe?

Den öffentlichen Schlüssel, einen generierten Pre-Shared Key, das Ablaufdatum, deine ROBERT-Filter und für jede Zahlung die Produktdetails, den Status und den Transaktions-Hash der Abwicklung. Windscribe speichert deine Wallet-Adresse nicht, aber die Abwicklung ist auf Base öffentlich und zeigt die zahlende Wallet.

Was ist, wenn mein WireGuard-Schlüssel bereits verwendet wird?

Ein Schlüssel, der zu einem Windscribe-Konto oder einem Partner gehört, wird mit wireguard_key_exists abgelehnt, bevor Geld bewegt wird. Erzeuge einen neuen Schlüssel und versuche es erneut.

Welche Server kann ich nutzen?

Die Premium-WireGuard-Standorte, die GET /vpn/wireguard/locations zurückgibt, solange dein Zugang aktiv ist. Server mit statischer IP sind nicht enthalten.