التثبيت والمصادقة
استخدم Node 22 أو أحدث. اضبط مفتاح API في متغير البيئة NARWHAL_API_KEY. أبقِ SDK على جانب الخادم ولا تضع المفتاح في كود المتصفح أبدًا. اتبع البدء السريع للإعداد.
// npm install narwhalapi
import { Narwhal } from "narwhalapi";
// Reads NARWHAL_API_KEY from the server environment.
const nw = new Narwhal();جلب أحدث منحنى عائد
اطلب عوائد USA لأجلي سنتين و10 سنوات. تحتوي الاستجابة على date وcurve_type وyields، مع maturity وyield_percent لكل عنصر. تصل القيم العشرية كسلاسل نصية دقيقة، مثل "4.25". راجع مرجع منحنى العائد.
const curve = await nw.economics.yieldCurve("USA", { maturity: ["2y", "10y"] }); console.log(curve.date, curve.curve_type); for (const point of curve.yields) { console.log(point.maturity, point.yield_percent); }قراءة السجل اليومي
اضبط start وend على نطاق التواريخ المطلوب. يمرّ المكرِّر على السجل اليومي صفحة بصفحة عند الحاجة، بما يصل إلى 1,000 تاريخ في الصفحة. يطلب هذا المثال عائد ألمانيا لأجل 10 سنوات.
for await (const day of nw.economics.yieldCurveHistoryIter("DEU", { maturity: ["10y"], start: "2026-01-01", end: "2026-03-31", })) { console.log(day.date, day.yields[0]?.yield_percent); }التحقق من انعكاس المنحنى
اطرح عائد السنتين من عائد الـ10 سنوات على المنحنى نفسه. الفارق السالب يعني انعكاس المنحنى. احسب فقط عندما يوجد الأجلان. يحوّل هذا المثال السلاسل النصية العشرية إلى أرقام للحساب.
const yieldOf = (maturity: string) => curve.yields.find((point) => point.maturity === maturity)?.yield_percent; const two = yieldOf("2y"); const ten = yieldOf("10y"); if (two && ten) { const spread = Number(ten) - Number(two); console.log(spread.toFixed(2), spread < 0 ? "inverted" : "not inverted"); }الأسئلة الشائعة
ما رموز الدول التي يمكنني استخدامها؟
استخدم USA أو GBR أو DEU أو JPN أو CAN. تحتفظ كل دولة بنوع منحنى المصدر الخاص بها، لذا تختلف آجال الاستحقاق والمقاييس المتاحة.
هل القيم العشرية سلاسل نصية أم أرقام؟
تصل القيم العشرية كسلاسل نصية دقيقة، مثل "4.25". ويجب أن تكون المدخلات العشرية سلاسل نصية أيضًا؛ ولا تُقبل الأرقام كمدخلات.
هل يمكنني مقارنة آجال الاستحقاق المتطابقة بين الدول؟
تحقق أولًا من نوع منحنى المصدر ومقياسه لكل دولة. تسمية أجل الاستحقاق نفسها لا تجعل المنحنيات قابلة للاستبدال.
تاريخ النشر . آخر مراجعة .