بوابة المطورين في BrokerTrust

تقدم BrokerTrust طريقتين لعرض بيانات الأسواق الحية على موقعك:

1. ويدجتات قابلة للتضمين — انسخ والصق المقتطف وانتهيت. بدون أي خطوة بناء.
2. واجهة REST API عامة — اجلب JSON من الواجهة الخلفية أو الأمامية لموقعك.

أسرع طريقة للبدء: انسخ مقتطف الشريط المتحرك التالي إلى صفحة HTML.

<div data-bt-widget="ticker" data-assets="bitcoin,ethereum,gold,oil"></div>
<script src="http://localhost:4173/embed.js" async></script>

شريط متحرك يعرض أحدث الأسعار. مثالي لرأس وذيل الصفحات. يُعيد ضبط حجم iframe تلقائياً ويُحدّث كل 30 ثانية.

<!-- Drop this anywhere on your page -->
<div data-bt-widget="ticker" data-assets="bitcoin,ethereum,gold,oil" data-theme="light"></div>
<script src="http://localhost:4173/embed.js" async></script>

بطاقة مدمجة تعرض السعر الحالي لأصل واحد، تغير 24 ساعة، والطابع الزمني. تُحدَّث كل 60 ثانية.

<!-- Drop this anywhere on your page -->
<div data-bt-widget="card" data-assets="bitcoin" data-theme="light"></div>
<script src="http://localhost:4173/embed.js" async></script>

جدول نظيف متعدد الأصول يُظهر آخر سعر، تغير 24 ساعة، والوحدة. مثالي للأشرطة الجانبية وصفحات نظرة عامة على السوق. يُحدَّث كل 60 ثانية.

<!-- Drop this anywhere on your page -->
<div data-bt-widget="table" data-assets="bitcoin,ethereum,gold,silver,oil,aramco" data-theme="light"></div>
<script src="http://localhost:4173/embed.js" async></script>

رسم بياني خطي خفيف لأصل واحد على مدى محدد (7 أو 30 أو 90 يوماً). يُظهر آخر سعر بالإضافة إلى نسبة التغير للمدى. يُحدَّث كل 5 دقائق — البيانات التاريخية يومية.

<!-- Drop this anywhere on your page -->
<div data-bt-widget="chart" data-asset="bitcoin" data-range="30d" data-theme="light"></div>
<script src="http://localhost:4173/embed.js" async></script>

واجهة JSON بسيطة للقراءة فقط. CORS مفتوح (*) لتتمكن من الجلب مباشرة من المتصفح.

أمثلة

curl https://pmmapwoadyuzrupxpyrl.supabase.co/functions/v1/public-api/v1/prices/bitcoin/latest

تُرجع نقاط أسعار يومية لأصل واحد ضمن نافذة محددة. days يجب أن تكون 7 أو 30 أو 90 — أي قيمة أخرى تُرجع bad_request. مُخزّنة مؤقتاً لمدة 5 دقائق.

curl "https://pmmapwoadyuzrupxpyrl.supabase.co/functions/v1/public-api/v1/prices/gold/history?days=30"

جميع الاستجابات الناجحة تتبع نفس البنية:

{
  "data": {
    "slug": "bitcoin",
    "category": "crypto",
    "price": 76579.42,
    "unit": "USD",
    "change_percent": 1.24,
    "date": "2026-04-18",
    "data_source": "CoinGecko"
  },
  "meta": {
    "source": "brokertrust",
    "updated_at": "2026-04-18T09:31:02.117Z",
    "cached": false
  }
}

تتشارك الأخطاء بنية واحدة قابلة للتنبؤ:

{
  "error": {
    "code": "invalid_slug",
    "message": "Unsupported asset slug: \"foo\". See /api/v1/assets for the supported list."
  },
  "meta": { "source": "brokertrust" }
}

الحد الافتراضي: 60 طلباً في الدقيقة لكل IP. كل استجابة تتضمن:

• X-RateLimit-Limit — الحد الأقصى (60).
• X-RateLimit-Remaining — الطلبات المتبقية في النافذة.
• X-RateLimit-Reset — طابع زمني Unix لإعادة ضبط النافذة.

تحتاج حدوداً أعلى؟ أنشئ مفتاح API للحصول على حصص يومية وشهرية مخصصة.