API docs

Put the key you create on the account page in the X-API-Key header. Up to 120 requests a minute.

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

Order energy

receiver (the wallet that sends USDT and gets the energy), energy (65,000 to 5,000,000 in steps of 1,000), duration ("1h", 1 hour only for now). Paid from your balance and refunded in full if not delivered.

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

Check orders

GET /api/v1/orders/{id}     one order
GET /api/v1/orders          last 100

status: queued, processing, delivered, failed (failed means refunded: true).

Balance and prices

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

Errors

401 invalid_api_key

The key is missing or wrong.

402 balance

Not enough balance. Nothing was charged.

400 address / inactive / energy / duration

A value is wrong, or the wallet is not activated.

503 closed / price / stock

Orders are not open right now. Nothing was charged.

502 supplier

We could not deliver the energy. Refunded in full.

429 rate_limited

Too many requests.