Einen VPS per POST deployen.

Von null zu Root in fünf Aufrufen.

Alle Endpunkte liegen unter https://vpscrypto.io/api/v1, sprechen JSON und erwarten (außer Kontoerstellung, Katalog und Health-Check) einen Authorization: Bearer-API-Schlüssel. Kein KYC, keine Karte.

1. Konto erstellen — gibt einen api_key (Ihr Bearer-Credential) und einen login_token für das Web-Dashboard zurück. Beide werden einmalig angezeigt.

curl -X POST https://vpscrypto.io/api/v1/account

# → {"api_key":"vpsk_…","login_token":"XXXX-XXXX-XXXX-XXXX", …}
export VPSK="vpsk_your_key_here"

2. Guthaben aufladen — eine Auflade-Rechnung in einem beliebigen unterstützten Coin erstellen (hier Monero):

curl -X POST https://vpscrypto.io/api/v1/topups \
  -H "Authorization: Bearer $VPSK" -H "Content-Type: application/json" \
  -d '{"amount":50,"coin":"XMR"}'

# → deposit_address + deposit_amount + ref. Pay it, then poll:
curl https://vpscrypto.io/api/v1/topups/<ref> -H "Authorization: Bearer $VPSK"

3. Server deployen — sobald das Guthaben aufgeladen ist, aus dem Katalog bestellen. Lassen Sie root_password weg und wir generieren ein starkes (wird einmalig zurückgegeben):

curl -X POST https://vpscrypto.io/api/v1/servers \
  -H "Authorization: Bearer $VPSK" -H "Content-Type: application/json" \
  -d '{"plan":"hunter","location":"nl","os":"debian-13"}'

# → {"server":{"id":123,"ip":null,"username":"root","root_password":"…"}}

Bearer-API-Schlüssel.

Authentifizieren Sie jeden Aufruf mit einem API-Schlüssel im Authorization-Header. Schlüssel beginnen mit vpsk_ und werden nur als Hash gespeichert — halten Sie sie geheim.

Authorization: Bearer vpsk_a3e5e745b6952c772f5731ab1d87fac4…

Holen Sie Ihren ersten Schlüssel über POST /account. Weitere Schlüssel erstellen, auflisten oder widerrufen Sie jederzeit:

Tarife, Standorte & Images.

Ein einziger öffentlicher Aufruf gibt alles zurück, was Sie für eine Bestellung benötigen — keine Authentifizierung erforderlich.

curl https://vpscrypto.io/api/v1/catalog

Plan-IDs reichen von pup → fenrir (10 Tarife). Standort-IDs: nl, fr, ro, bg, se, is, ch, my. Images umfassen Debian 12, Debian 13, Ubuntu 24.04 LTS, Ubuntu 22.04 LTS, AlmaLinux 9, Rocky Linux 9 und mehr. Monatspreis = Basis × Standort-Multiplikator; jährlich = ×10 (2 Monate gratis).

Guthaben in Krypto aufladen.

Aufladungen sind prepaid und ausschließlich on-chain ($25–$2000). Klassische Coins geben eine Einzahlungsadresse zurück; USDCBASE gibt eine x402-Challenge für gaslose Abrechnung zurück.

Unterstützte Coins: BTC, XMR, ETH, LTC, USDTTRC, USDT, plus USDCBASE für x402. Abfrage der Referenz bis status den Wert completed hat — dann wird das Guthaben gutgeschrieben.

Bestellen & verwalten.

Eine Bestellung belastet den Preis in einem atomaren Schritt von Ihrem Guthaben. Eine 402 insufficient_balance-Antwort enthält das genaue deficit, sodass ein Agent weiß, wie viel er aufladen muss.

Das Root-Passwort wird einmalig bei der Erstellung zurückgegeben und ist jederzeit über den Credentials-Endpunkt abrufbar. Per SSH verbinden wie in der Dokumentation beschrieben.

Vorhersehbare Fehler.

Fehler verwenden Standard-HTTP-Statuscodes mit einem stabilen, maschinenlesbaren Body. 402 bedeutet, dass ein Zahlungsschritt erforderlich ist (unzureichendes Guthaben oder eine x402-Challenge).

{
  "error": "insufficient_balance",
  "message": "Top up your balance before ordering. Deficit: $19.00.",
  "price": 19, "balance": 0, "deficit": 19
}

• 200 / 201 — Erfolg.
• 400 — Ungültige Eingabe (invalid_plan, invalid_coin, amount_too_low…).
• 401 — Fehlender oder ungültiger API-Schlüssel (unauthorized).
• 402 — Zahlung erforderlich (insufficient_balance oder ein x402-accepts-Block).
• 404 — Unbekannte Ressource. 5xx — Kurz warten und erneut versuchen.

Der vollständige maschinenlesbare Vertrag befindet sich in der OpenAPI 3.1-Spezifikation.