المقاييس

تحمل كل نتيجة ناجحة من /v1/quotes كائن metrics. جميع المعدلات أرقام عشرية؛ والأسعار لكل 100 من القيمة الاسمية.

السعر والفائدة المستحقة

Field	Meaning
dirty_price	السعر الكامل (القيمة الحالية للتدفقات النقدية المتبقية)
clean_price	السعر الكامل مطروحًا منه الفائدة المستحقة
accrued_interest	الفائدة المتراكمة منذ آخر كوبون (coupon corrido)
accrued_days	أيام التراكم عند التسوية

العائد

Field	Meaning
yield	العائد، محسوبًا على أساس rate_type الخاص بالأداة
current_yield	الكوبون السنوي ÷ السعر
tec	TEC — معدل الشراء الفعلي السنوي الدقيق (وليس تقديرًا تقريبيًا)
yield_to_worst	للأدوات القابلة للاستدعاء فقط — min(عائد حتى الاستحقاق YTM، جميع العوائد حتى الاستدعاء)؛ يظهر عند تفعيل options.yield_worst وفي حال انطباقه

المخاطر

Field	Meaning
macaulay_duration	المتوسط المرجح للزمن حتى التدفقات النقدية (بالسنوات)
modified_duration	حساسية السعر للعائد (−dP/dy ÷ P)
convexity	حساسية السعر/العائد من الدرجة الثانية
dv01	التغير النقدي في السعر لكل تحرك بمقدار نقطة أساس واحدة في العائد
sherman_ratio	العائد لكل وحدة من المدة
duration_applicable	تكون false لـ PRICE_QUANTITY (مقاييس المخاطر غير ذات معنى في هذه الحالة)

المبالغ النقدية (عند تزويد قيمة amount)

إذا تضمّن عرض السعر amount_kind / amount_value، فإن النتيجة تضيف كتلة amounts تقوم بتحجيم الأسعار لكل 100 وفقًا لحجم الصفقة:

Field	Meaning
nominal	القيمة الاسمية المحسوبة
clean_amount	السعر النظيف × القيمة الاسمية / 100
accrued_amount	الفائدة المستحقة × القيمة الاسمية / 100
dirty_amount	السعر الكامل × القيمة الاسمية / 100 (نقد التسوية)
quantity	القيمة الاسمية ÷ unit_nominal

الكوبون التالي والتدفقات النقدية

تتضمن كل نتيجة ملخصًا لـ next_coupon (date، interest، amortization، total، present_value). اضبط options.with_cashflows: true لتتلقى أيضًا الجدول المخصوم الكامل (كل تدفق مع تاريخه، ومبلغه، وعامل الخصم، والقيمة الحالية).

:::info How yields are solved عند تسعير الأداة وفقًا للسعر، يقوم emrgex بعكس السعر ← العائد باستخدام حلّال هجين يجمع بين طريقتي Newton-Raphson وBrent محصورٍ ضمن حدود لضمان التقارب. أي عملية حلّ لا تتقارب تُرجع خطأ 422 مُصنّفًا، ولا تُرجع أبدًا رقمًا خاطئًا بصمت. :::