Tài liệu API

Đặt khóa bạn tạo ở trang tài khoản vào header X-API-Key. Tối đa 120 yêu cầu mỗi phút.

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

Đặt năng lượng

receiver (ví gửi USDT và nhận năng lượng), energy (65,000 đến 5,000,000, bước 1,000), duration ("1h", hiện chỉ có 1 giờ). Trả từ số dư của bạn và được hoàn đủ nếu không giao được.

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,...}}

Kiểm tra đơn

GET /api/v1/orders/{id}     một đơn
GET /api/v1/orders          100 đơn gần nhất

status: queued, processing, delivered, failed (failed nghĩa là refunded: true).

Số dư và giá

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

Lỗi

401 invalid_api_key

Thiếu khóa hoặc khóa sai.

402 balance

Không đủ số dư. Chưa bị trừ tiền.

400 address / inactive / energy / duration

Có giá trị sai, hoặc ví chưa được kích hoạt.

503 closed / price / stock

Hiện chưa nhận đơn. Chưa bị trừ tiền.

502 supplier

Chúng tôi không giao được năng lượng. Đã hoàn đủ.

429 rate_limited

Quá nhiều yêu cầu.