emrgex — حاسبة الدخل الثابت

emrgex هي واجهة برمجة تطبيقات (API) لتسعير أدوات الدخل الثابت (renta fija). أرسل إليها سنداً وعرض سعر فتُعيد لك السعر والعائد والفائدة المستحقة ومجموعة كاملة من مقاييس المخاطر — أو أرسل سعراً فتحلّ لإيجاد العائد. وهي تتعامل مع السندات الحكومية والسندات الشركاتية وأذونات سوق النقد والهياكل المستهلِكة لأصلها (amortizing) والقابلة للاستدعاء (callable) والأدوات المرتبطة بمؤشر.

ماذا تفعل

• السعر ↔ العائد. قدّم عرض السعر بـ yield أو clean_price أو dirty_price أو بمبلغ نقدي transacted؛ وتحسب emrgex ما تبقّى.
• مقاييس المخاطر. السعر النظيف/الإجمالي، والفائدة المستحقة، ومدّة ماكولاي والمدّة المعدّلة، والتحدّب (convexity)، وDV01، والعائد الجاري (current yield)، وTEC (المعدّل الفعّال السنوي للشراء)، ونسبة شيرمان (Sherman ratio)، والعائد حتى الأسوأ (yield-to-worst) للسندات القابلة للاستدعاء.
• التدفقات النقدية والكاري. ولّد جدول التدفقات النقدية لسند ما، أو احسب الكاري (carry) اليومي حتى أفق زمني محدد.
• المعالجة المجمّعة (Batch). سعّر آلاف الأدوات في طلب واحد.

الفكرة الجوهرية: أعراف عالمية مُسمّاة

بدلاً من رموز غامضة خاصة بكل منتج، يُعرَّف الحساب في emrgex بثلاثة محاور مستقلة ومعترف بها عالمياً:

المحور	ما يحدّده	أمثلة
rate_type	كيفية مراكمة العائد (compounding)	NOMINAL, EFFECTIVE, AT_MATURITY
day_count	كيفية قياس الزمن (FpML / ISDA)	ACT/ACT.ICMA, 30E/360, BUS/252
coupon_type	كيفية حساب مبلغ القسيمة (coupon)	FIXED, ACCRUAL

يتركّب أي rate_type مع أي day_count؛ واقترانهما هو calculation_code الخاص بالأداة (مثل ACT/ACT.ICMA|NOMINAL). انظر الأعراف.

طريقتان للتسعير

• الأدوات المخزّنة — أشِر إلى سند موجود مسبقاً في الكتالوج عبر id الخاص به.
• الأدوات الفورية (Ad-hoc) — عرّف السند ضمن طلبك مباشرةً.

تعيد كلتا الطريقتين حساب التقييم الكامل في كل استدعاء. انظر الأدوات.

الخطوات التالية

• البدء — قدّم أول طلب لك.
• مرجع API — نقطة النهاية /v1/quotes بالكامل.
• أمثلة — وصفات جاهزة للنسخ واللصق.

:::note Base URL خدمة التطوير متاحة على https://calc.dev.emrgex.com. تقع كل نقاط النهاية تحت /v1. :::