API 문서

계정 화면에서 만든 키를 헤더 X-API-Key에 넣어 요청해요. 1분에 120번까지예요.

기본 주소https://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

요청이 너무 많아요.