Despliega un VPS con un POST.

De cero a root, en cinco llamadas.

Cada endpoint vive en https://vpscrypto.io/api/v1, habla JSON y (salvo la creación de cuenta, el catálogo y el health) espera una clave API Authorization: Bearer. Sin KYC, sin tarjeta.

1. Crea una cuenta — devuelve una api_key (tu credencial Bearer) y un login_token para el panel web. Ambos se muestran una sola vez.

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. Fondea tu saldo — crea una factura de recarga en cualquier moneda admitida (aquí 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. Despliega un servidor — una vez fondeado el saldo, pide del catálogo. Omite root_password y generaremos uno seguro (devuelto una sola vez):

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":"…"}}

Claves API Bearer.

Autentica cada llamada con una clave API en la cabecera Authorization. Las claves comienzan con vpsk_ y se almacenan solo como hash — mantenlas en secreto.

Authorization: Bearer vpsk_a3e5e745b6952c772f5731ab1d87fac4…

Obtén tu primera clave desde POST /account. Crea más, listarlas o revocarlas en cualquier momento:

Planes, ubicaciones e imágenes.

Una sola llamada pública devuelve todo lo necesario para crear un pedido — no requiere autenticación.

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

Los IDs de plan van de pup a fenrir (10 niveles). IDs de ubicación: nl, fr, ro, bg, se, is, ch, my. Las imágenes incluyen Debian 12, Debian 13, Ubuntu 24.04 LTS, Ubuntu 22.04 LTS, AlmaLinux 9, Rocky Linux 9 y más. Precio mensual = base × modificador de ubicación; anual = ×10 (2 meses gratis).

Fondea el saldo en cripto.

Las recargas son prepago y exclusivamente en cadena ($25–$2000). Las monedas clásicas devuelven una dirección de depósito; USDCBASE devuelve un desafío x402 para liquidación sin gas.

Monedas admitidas: BTC, XMR, ETH, LTC, USDTTRC, USDT, más USDCBASE para x402. Consulta la referencia hasta que status sea completed — entonces el saldo queda acreditado.

Contratar y gestionar.

El pedido descuenta el precio de tu saldo en un paso atómico. Una respuesta 402 insufficient_balance incluye el deficit exacto para que el agente sepa cuánto recargar.

La contraseña root se devuelve una sola vez al crear el servidor y siempre puede obtenerse desde el endpoint de credenciales. Conéctate por SSH tal como se documenta en la Documentación.

Fallos predecibles.

Los errores usan códigos de estado HTTP estándar con un cuerpo legible por máquina y estable. 402 significa que se requiere un paso de pago (saldo insuficiente o un desafío x402).

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

• 200 / 201 — éxito.
• 400 — entrada incorrecta (invalid_plan, invalid_coin, amount_too_low…).
• 401 — clave API ausente o no válida (unauthorized).
• 402 — pago requerido (insufficient_balance o un bloque x402 accepts).
• 404 — recurso desconocido. 5xx — reintenta en breve.

El contrato legible por máquina completo está en la especificación OpenAPI 3.1.