Documentación de la API

Pon la clave que creas en la página de cuenta en la cabecera X-API-Key. Hasta 120 solicitudes por minuto.

URL basehttps://vtether.com/api/v1

Pedir energía

receiver (la billetera que envía USDT y recibe la energía), energy (de 65,000 a 5,000,000 en pasos de 1,000), duration ("1h", por ahora solo 1 hora). Se paga con tu saldo y se reembolsa íntegramente si no se entrega.

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

Consultar pedidos

GET /api/v1/orders/{id}     un pedido
GET /api/v1/orders          últimos 100

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

Saldo y precios

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

Errores

401 invalid_api_key

Falta la clave o es incorrecta.

402 balance

Saldo insuficiente. No se cobró nada.

400 address / inactive / energy / duration

Un valor es incorrecto o la billetera no está activada.

503 closed / price / stock

Los pedidos no están abiertos ahora. No se cobró nada.

502 supplier

No pudimos entregar la energía. Reembolsado íntegramente.

429 rate_limited

Demasiadas solicitudes.