API 文档

把在账户页面创建的密钥放在 X-API-Key 请求头中。每分钟最多 120 次请求。

Base URLhttps://vtether.com/api/v1

购买能量

receiver (发送 USDT 并接收能量的钱包)，energy (65,000 到 5,000,000，以 1,000 为单位)，duration ("1h"，目前仅支持 1 小时)。从余额扣款，未能发放则全额退款。

curl -X POST https://vtether.com/api/v1/orders \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"receiver":"TXYZ...","energy":65000,"duration":"1h"}'

{"order":{"id":"K7M2Q9XA3B","receiver":"TXYZ...","energy":65000,"duration":"1h",
 "cost":"0.3","currency":"USD","status":"delivered","refunded":false,...}}

查询订单

GET /api/v1/orders/{id}     单个订单
GET /api/v1/orders          最近 100 个

status：queued、processing、delivered、failed (failed 表示 refunded: true)。

余额和价格

GET /api/v1/balance   {"balance":"42.5","currency":"USD"}
GET /api/v1/prices    {"open":true,"per_energy":65000,"prices":{"1h":"0.3"}}

错误

401 invalid_api_key

密钥缺失或错误。

402 balance

余额不足，未扣款。

400 address / inactive / energy / duration

参数有误，或钱包未激活。

503 closed / price / stock

当前暂停下单，未扣款。

502 supplier

能量未能发放，已全额退款。

429 rate_limited

请求过多。