Triển khai VPS bằng một lệnh POST.

Từ không đến root, trong năm lệnh gọi.

Mọi endpoint đều nằm dưới https://vpscrypto.io/api/v1, giao tiếp JSON, và (trừ tạo tài khoản, danh mục và health) yêu cầu khoá API Authorization: Bearer. Không KYC, không thẻ.

1. Tạo tài khoản — trả về api_key (thông tin đăng nhập Bearer của bạn) và login_token cho bảng điều khiển web. Cả hai chỉ hiển thị một lần.

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. Nạp số dư — tạo hoá đơn nạp tiền bằng bất kỳ coin nào được hỗ trợ (ở đây là 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. Triển khai máy chủ — sau khi số dư được nạp, đặt lệnh từ danh mục. Bỏ qua root_password và chúng tôi sẽ tạo mật khẩu mạnh (trả về một lần):

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

Khoá API Bearer.

Xác thực mọi lệnh gọi bằng khoá API trong header Authorization. Khoá bắt đầu bằng vpsk_ và chỉ được lưu dưới dạng hash — giữ bí mật.

Authorization: Bearer vpsk_a3e5e745b6952c772f5731ab1d87fac4…

Lấy khoá đầu tiên từ POST /account. Tạo thêm, liệt kê hoặc thu hồi bất cứ lúc nào:

Gói, vị trí & image.

Một lệnh gọi công khai duy nhất trả về mọi thứ bạn cần để xây dựng lệnh — không cần xác thực.

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

ID gói chạy từ pup → fenrir (10 tầng). ID vị trí: nl, fr, ro, bg, se, is, ch, my. Image bao gồm Debian 12, Debian 13, Ubuntu 24.04 LTS, Ubuntu 22.04 LTS, AlmaLinux 9, Rocky Linux 9 và nhiều hơn. Giá hàng tháng = cơ bản × hệ số vị trí; hàng năm = ×10 (miễn phí 2 tháng).

Nạp số dư bằng crypto.

Nạp tiền được trả trước và chỉ on-chain ($25–$2000). Coin thông thường trả về địa chỉ nạp; USDCBASE trả về thách thức x402 để thanh toán không gas.

Coin được hỗ trợ: BTC, XMR, ETH, LTC, USDTTRC, USDT, cộng với USDCBASE cho x402. Poll ref cho đến khi status là completed — đó là lúc số dư được ghi nhận.

Đặt lệnh & quản lý.

Đặt lệnh trừ giá từ số dư của bạn trong một bước nguyên tử. Phản hồi 402 insufficient_balance bao gồm chính xác deficit để tác nhân biết cần nạp bao nhiêu.

Mật khẩu root được trả về một lần khi tạo và luôn có thể tiết lộ từ endpoint thông tin đăng nhập. Kết nối qua SSH như tài liệu trong Tài liệu.

Lỗi có thể dự đoán.

Lỗi sử dụng mã trạng thái HTTP tiêu chuẩn với nội dung ổn định có thể đọc bằng máy. 402 có nghĩa là cần bước thanh toán (không đủ số dư, hoặc thách thức x402).

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

• 200 / 201 — thành công.
• 400 — dữ liệu đầu vào lỗi (invalid_plan, invalid_coin, amount_too_low…).
• 401 — thiếu hoặc khoá API không hợp lệ (unauthorized).
• 402 — yêu cầu thanh toán (insufficient_balance, hoặc khối accepts x402).
• 404 — tài nguyên không xác định. 5xx — thử lại sau.

Hợp đồng đầy đủ có thể đọc bằng máy nằm trong đặc tả OpenAPI 3.1.