التوثيق /

مرجع API

عقد REST الكامل: المصادقة والحدود وحقول الحداثة ونقاط النهاية والأخطاء.

المصادقة والحدود

تدعم endpoints البيانات تجربة مجهولة: 12 طلبًا في الدقيقة و100 في الساعة لكل IP. يستخدم الطلب بالمفتاح الحصة الشهرية للحساب.

bash · header
Authorization: Bearer YOUR_KEY
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800

حقول تشرح حداثة البيانات

يحدد `source` فئة المصدر، ويصف `market_session` حالة السوق، ويبيّن `data_updated_at` وقت كتابة الرقم. احتفظ بالثلاثة.

نقاط النهاية

GET /v1/latest[/{BASE}]الأسعار الحالية، كلها أو مفلترة عبر symbols.
GET /v1/{YYYY-MM-DD}[/{BASE}]لقطة تاريخية لتاريخ وعملة أساس.
GET /v1/convert/{FROM}/{TO}[/{AMOUNT}] · POST /v1/convertتحويل مبلغ عبر GET أو دفعة عبر POST.
GET /v1/rate/{slug}سعر زوج واحد بواسطة slug.
GET /v1/rangeسلسلة يومية مع ترقيم وتنزيلات.
GET /v1/currenciesقائمة العملات المدعومة دون معاملات.
GET /v1/accountالحساب والخطة والمفتاح النشط واستهلاك الشهر.

الأخطاء

كل خطأ يستخدم `{ result: "error", code, message }`. تضيف 429 ترويسة `Retry-After`، ولا تُستخدم بيانات وهمية عند تعطل المصدر.

json · error
{
  "result": "error",
  "code": "missing_parameter",
  "message": "missing required parameter: symbols"
}

English complete field-by-field reference →