كيف تجلب TypeScript SDK أسعار الفائدة

تعرّف على TypeScript SDK أسعار الفائدة عبر استدعاءات تجلب عوائد الأجل القصير الحكومية ومسار السياسة النقدية المتوقع من السوق. أسعار السياسة الرسمية غير متاحة.

إعداد العميل

استخدم Node 22 أو أحدث واضبط NARWHAL_API_KEY في بيئة خادمك. لا تضع مفتاح API في كود المتصفح أبدًا. ثبّت الحزمة وأنشئ العميل. راجع البدء السريع.

التثبيت وإنشاء العميل
// npm install narwhalapi
import { Narwhal } from "narwhalapi";

// Reads NARWHAL_API_KEY from the server environment.
const nw = new Narwhal();

جلب أسعار الفائدة السوقية من العوائد قصيرة الأجل

اطلب عوائد الحكومة قصيرة الأجل كأسعار فائدة سوقية. يتوفر عائد 3 أشهر حيث ينشره المصدر. تختلف آجال الاستحقاق المتاحة حسب الدولة والتاريخ؛ وتُحذف الآجال المفقودة. تصل القيم العشرية كسلاسل نصية دقيقة، ولا يمكن أن تكون المدخلات العشرية أرقامًا.

عائدا المملكة المتحدة لأجل 3 أشهر وسنتين
const short = await nw.economics.yieldCurve("GBR", { maturity: ["3m", "2y"] }); for (const point of short.yields) { console.log(point.maturity, point.yield_percent); }

قراءة مسار السياسة النقدية الذي يعكسه السوق

اطلب مسار سعر السياسة النقدية لبنك إنجلترا الذي يعكسه السوق. تتضمن الاجتماعات p_cut وp_hold وp_hike كسلاسل نصية للاحتمالات، إضافة إلى expected_change_bps وcumulative_change_bps وresolves_at. هذه احتمالات أسواق التنبؤ لا توقعات رسمية.

المسار الذي يعكسه السوق لبنك إنجلترا
const path = await nw.predictions.policyPath("bank-of-england"); for (const meeting of path.meetings) { console.log(meeting.resolves_at, meeting.p_cut, meeting.p_hold, meeting.p_hike); }

الأسئلة الشائعة

هل يمكنني جلب سعر الفائدة الحالي للسياسة النقدية لدى بنك مركزي؟

لا. لا تملك Narwhal نقطة نهاية لسعر الفائدة الرسمي الحالي للسياسة النقدية. يمكنك جلب عوائد الحكومة قصيرة الأجل والاحتمالات التي يعكسها السوق لاجتماعات السياسة النقدية القادمة.

لماذا عائد 3 أشهر مفقود؟

تعتمد آجال الاستحقاق المتاحة على مصدر الدولة والتاريخ المطلوب. تُحذف الآجال المفقودة، فلا يُعاد عائد 3 أشهر إلا حيث ينشره المصدر.

ما الجهات الأخرى المحددة للسياسة النقدية التي يمكنني الاستعلام عنها؟

من الجهات الأخرى bank-of-canada وbank-of-japan وbank-indonesia. تعكس مسارات سياساتها احتمالات أسواق التنبؤ لا التوقعات الرسمية.

تاريخ النشر . آخر مراجعة .

انتقل إلى المرجع الدقيق