توثيق API

ضع المفتاح الذي تنشئه في صفحة الحساب داخل ترويسة X-API-Key. حتى 120 طلبًا في الدقيقة.

عنوان URL الأساسيhttps://vtether.com/api/v1

طلب الطاقة

receiver (المحفظة التي ترسل USDT وتستلم الطاقة)، energy (من 65,000 إلى 5,000,000 بخطوات 1,000)، duration ("1h"، ساعة واحدة فقط حاليًا). يُدفع من رصيدك ويُعاد المبلغ كاملًا إذا لم يتم التسليم.

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

طلبات كثيرة جدًا.

توثيق API | vTether