01 — 快速入门
五次调用，从零到 root。
每个端点均位于 https://vpscrypto.io/api/v1，使用 JSON，并（创建账户、目录和健康检查端点除外）需要 Authorization: Bearer API 密钥。无 KYC，无银行卡。
1. 创建账户 — 返回 api_key（您的 Bearer 凭证）和用于 Web 仪表盘的 login_token。两者均仅显示一次。
bash
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. 充值余额 — 以任意支持的币种创建充值账单（此处以 Monero 为例）：
bash
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. 部署服务器 — 余额充值完成后，从目录下单。省略 root_password 时，我们将自动生成强密码（仅返回一次）：
bash
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":"…"}}
希望全流程无人工参与——包括支付？使用 coin: "USDCBASE" 通过 x402 在 Base 链上无 gas 支付。参阅代理指南。
02 — 身份认证
Bearer API 密钥。
通过 Authorization 请求头中的 API 密钥验证每次调用。密钥以 vpsk_ 开头，仅以哈希形式存储——请妥善保管。
http
Authorization: Bearer vpsk_a3e5e745b6952c772f5731ab1d87fac4…
从 POST /account 获取您的第一个密钥。随时铸造更多、列出或撤销：
POST/api/v1/keys铸造新密钥
GET/api/v1/keys列出活跃密钥
DELETE/api/v1/keys/{id}撤销密钥
POST /account 返回的 login_token 可在 /account 登录 Web 仪表盘——同一账户，两种凭证。
03 — 目录
套餐、机房位置与镜像。
单次公开调用即可获取下单所需的全部信息——无需认证。
bash
curl https://vpscrypto.io/api/v1/catalog
套餐 id 从 pup 到 fenrir（10 个等级）。机房位置 id：nl, fr, ro, bg, se, is, ch, my。镜像包含 Debian 12, Debian 13, Ubuntu 24.04 LTS, Ubuntu 22.04 LTS, AlmaLinux 9, Rocky Linux 9 等。月付价格 = 基础价 × 位置系数；年付 = ×10（2 个月免费）。
04 — 充值
以加密货币充值余额。
充值为预付且仅限链上方式（$25–$2000）。经典币种返回充值地址；USDCBASE 返回用于无 gas 结算的 x402 质询。
POST/api/v1/topups创建账单 / x402
GET/api/v1/topups/{ref}轮询状态，余额到账
支持的币种：BTC, XMR, ETH, LTC, USDTTRC, USDT，以及用于 x402 的 USDCBASE。轮询 ref 直到 status 为 completed——此时余额已到账。
加密结算不可逆；充值不可退款。关于 x402（Base 链 USDC）签名支付流程，请参阅代理指南。
05 — 服务器
下单与管理。
下单操作以原子方式从余额中扣除费用。402 insufficient_balance 响应包含精确的 deficit 值，代理可据此判断需要充值多少。
POST/api/v1/servers从余额下单
GET/api/v1/servers列出您的服务器
GET/api/v1/servers/{id}单台服务器详情
GET/api/v1/servers/{id}/credentials显示 root 登录信息
root 密码在创建时返回一次，并始终可通过凭证端点再次查看。按照文档中的说明通过 SSH 连接。
06 — 错误与限制
可预期的失败。
错误使用标准 HTTP 状态码，并附带稳定的机器可读响应体。402 表示需要支付步骤（余额不足，或 x402 质询）。
json
{
"error": "insufficient_balance",
"message": "Top up your balance before ordering. Deficit: $19.00.",
"price": 19, "balance": 0, "deficit": 19
}
- 200 / 201 — 成功。
- 400 — 输入错误（
invalid_plan、invalid_coin、amount_too_low…）。
- 401 — API 密钥缺失或无效（
unauthorized）。
- 402 — 需要支付（
insufficient_balance，或 x402 accepts 块）。
- 404 — 未知资源。5xx — 稍后重试。
完整的机器可读契约参见 OpenAPI 3.1 规范。
VPSCrypto
