توثيق 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 آخر 100status: 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طلبات كثيرة جدًا.