API الخاص بـ EMpulse Street FX Index
أسعار الصرف اليومية في السوق الموازية لعملات الأسواق الناشئة، مسعّرة بالعملة الورقية مقابل 1 USDT (يُعامَل USDT على أنه 1 USD): السعر الذي يدفعه الناس فعلًا، لا السعر الرسمي. تحمل كل سلسلة فئة ثقة. المنهجية الكاملة في المنهجية.
حقول صف المؤشر
| الحقل | المعنى | متى تكون القيمة null | الخطة |
|---|---|---|---|
buy | متوسط سعر اليوم المرجّح الذي يشتري به العميل USDT مقابل العملة الورقية. | عدد نقاط البيانات لجانب الشراء في هذا اليوم قليل جدًا. | جميع الخطط |
sell | المتوسط نفسه للجانب الذي يبيع فيه العميل USDT. | عدد نقاط البيانات لجانب البيع في هذا اليوم قليل جدًا. | جميع الخطط |
mid | (الشراء + البيع) / 2 عند وجود الجانبين؛ وعند وجود جانب واحد فقط يكون السعر الوسطي هو سعر ذلك الجانب. | لا يوجد في أي من الجانبين عدد كافٍ من نقاط البيانات. | جميع الخطط |
side | الجانبان اللذان يُبنى منهما السعر الوسطي: both أو buy أو sell. السعر الوسطي المبني من جانب واحد يكون منحرفًا بنحو نصف الفارق مقارنةً بالمبني من جانبين. | لا يوجد سعر وسطي. | جميع الخطط |
spread_pct | (الشراء − البيع) / السعر الوسطي × 100. | قيمة الجانب ليست both. | جميع الخطط |
confidence | high أو medium أو limited: فئة العملة بحسب تغطيتها؛ ويُخفَّض اليوم الذي تقل فيه نقاط البيانات عن المعتاد فئةً واحدة. تعني limited مصادر أو نقاط بيانات أقل، أي ضوضاء أكثر وفجوات محتملة. | أبدًا. | جميع الخطط |
flag | outlier ليوم ذي عدد قليل من نقاط البيانات ينحرف سعره الوسطي عن الوسيط للأسعار الوسطية في ±15 يومًا المحيطة بأكثر من 10%. يحتفظ هذا اليوم بقيمه لكنه يُستبعد من mid_7d ومن حقول chg_*. | اليوم ليس قيمة شاذة. | جميع الخطط |
in_progress | true لآخر يوم لعملة ما أثناء استمرار جمع بياناته، حين تكون نقاط بياناته أدنى بوضوح من المعدل المعتاد في الأيام 7 السابقة. | أبدًا. | جميع الخطط |
mid_7d | متوسط الأسعار الوسطية الصالحة خلال آخر 7 أيام تقويمية، شاملةً اليوم الأخير. | لا يوجد سعر وسطي صالح ضمن النافذة. | جميع الخطط |
chg_1d_pct | التغير في السعر الوسطي مقارنةً بما قبل يوم تقويمي واحد بالضبط، بالنسبة المئوية. | لا يوجد سعر وسطي صالح في أحد اليومين. | جميع الخطط |
chg_7d_pct | التغير في السعر الوسطي مقارنةً بما قبل 7 أيام تقويمية بالضبط، بالنسبة المئوية. | لا يوجد سعر وسطي صالح في أحد اليومين. | جميع الخطط |
chg_30d_pct | التغير في السعر الوسطي مقارنةً بما قبل 30 يومًا تقويميًا بالضبط، بالنسبة المئوية. | لا يوجد سعر وسطي صالح في أحد اليومين. | جميع الخطط |
exchange_spread_pct | مدى التباعد في اليوم بين البورصات التي تسعّر العملة: (أعلى سعر وسطي لبورصة − أدنى سعر وسطي لبورصة) / الوسيط × 100. اتساع هذا الفارق أحد مدخلات FX Stress Signals. | تسعّر العملةَ أقلُّ من بورصتين، أو أن المفتاح مجاني. | Pro، Enterprise |
التواريخ هي أيام تقويمية بتوقيت UTC. يبقى اليوم الأخير غير مكتمل حتى ينتهي وقد يُراجَع؛ وقد تتغير أعلام الأيام 15 الأخيرة مع وصول بيانات جديدة.
الأسعار بالساعة (Pro وEnterprise). يعيد GET /v1/rates/CUR/hourly?from=&to= المؤشر لكل ساعة UTC (بحد أقصى 31 يومًا في الطلب الواحد)، ويعيد /v1/rates/CUR/hourly/latest آخر 24 ساعة من السلسلة، ويعيد /v1/rates/hourly/latest آخر ساعة مكتملة لكل عملة. تحمل صفوف الساعات الحقول نفسها: buy وsell وmid وside وspread_pct وconfidence وin_progress؛ وتضيف الاستجابات الخاصة بكل عملة summary لكل يوم. تحصل المفاتيح المجانية على الخطأ 403 tier_not_in_plan.
مؤشر السوق الموازية متعدد المصادر. /v1/street-index/* — أسعار السوق الموازية مجمّعة من مصادر سوق عامة مستقلة عديدة مع درجة ثقة، لكل عملة تغطيها المصادر (المفتاح نفسه).
أرسل مفتاحك في الترويسة X-API-Key. المجاني: RUB, UAH, EGP فقط، 100 طلبًا في اليوم، حتى آخر يوم مكتمل. Pro: جميع العملات، 10,000 طلبًا في اليوم، ويشمل اليوم الجاري (غير المكتمل). Enterprise: بحسب العقد. تُعاد تهيئة الحدود عند 00:00 UTC.
الصيغة الافتراضية JSON؛ أرسل Accept: text/csv أو أضف ?format=csv للحصول على CSV. الأخطاء تُعاد بصيغة JSON وفيها الكائن error الذي يحتوي على code وmessage، مع الحالة 400 (معلمات غير صحيحة)، أو 401 (مفتاح مفقود أو غير صالح)، أو 403 (الفترة أو العملة أو المنتج غير مشمول في الخطة: tier_delay وcurrency_not_in_plan وtier_not_in_plan وkey_frozen)، أو 404 (عملة أو مسار غير معروف)، أو 429 (rate_limit_exceeded وhistory_quota_exceeded)، أو 503.
الصفوف الأقدم من 90 يومًا تُحتسب ضمن حصة يومية لكل مفتاح (المجاني 1,000 والـ Pro 3,000 صفًا لكل يوم UTC)؛ والتصدير الكامل متاح بموجب اتفاقية Enterprise. المفاتيح شخصية، والتنزيل الجماعي الآلي يؤدي إلى تجميد المفتاح. راجع الشروط.
أسعار السوق الموازية ليست أسعارًا رسمية ولا أسعار سوق ما بين البنوك؛ والسلاسل التي قيمة confidence فيها limited قد تتضمن تشويشًا وفجوات. البيانات ليست نصيحة استثمارية.