واجهة API للمطوّرين

تتيح «أسعار» للشركات والمؤسسات قراءة الأسعار المعتمدة (السوق الموازي نقدًا وبالصكوك، والحوالات، والسعر الرسمي) ودمجها في أنظمتها. أنشئ مفتاح وصول من بوابة المطوّرين وابدأ خلال دقائق.

بوابة المطوّرين ومفاتيح الوصول

الباقات

للترقية إلى باقة مدفوعة تواصل مع إدارة المنصة؛ الدفع عبر رصيد ليبيانا والمدار قيد التجهيز.

التوثيق

نقطة الوصول: GET /api/public/v1/rates

المصادقة: أرسل المفتاح في الترويسة Authorization: Bearer <key> أو x-api-key.

المعاملات (اختيارية):

currency: رمز العملة مثل USD أو EUR.
market: cash (نقدًا) أو cheque (صكوك) أو transfer (حوالات) أو official (رسمي).
days: عدد الأيام السابقة من 1 إلى 365 (الافتراضي 1).
limit: أقصى عدد للنتائج من 1 إلى 1000 (الافتراضي 200).

الأخطاء: 401 مفتاح مفقود أو غير صالح، 429 تجاوز الحد اليومي، 400 معاملات غير صحيحة.

curl "https://YOUR-DOMAIN/api/public/v1/rates?currency=USD&market=cash&days=7" \
  -H "Authorization: Bearer asr_xxxxxxxx"

{
  "data": [
    { "currency": "USD", "market": "cash", "buy": 7.2, "sell": 7.25,
      "unit": 1, "observed_at": "2026-10-28T08:00:00Z",
      "source": "سوق المشير - طرابلس", "bank": null, "destination": null }
  ],
  "usage": { "used_today": 12, "daily_quota": 100 }
}

الأسعار المعروضة للمعلومات فقط، والمنصة لا تنفّذ عمليات صرافة أو تحويل.