مرجع funds API للصناديق

الأسعار وصافي قيمة الأصول (NAV) والسجل التاريخي والتوزيعات لصناديق ETF وصناديق الاستثمار المشتركة

نظرة عامة

الأسعار وسجل الأسعار والتوزيعات والملفات التعريفية والبحث لصناديق ETF والصناديق المشتركة. يتطلب كل طلب مفتاح Bearer، ويخصم REST وMCP من رصيد واحد.

معرّف صندوق ETF هو معرّف رمزه المُدرج، مثل ARCX:SPY. ومعرّف صندوق الاستثمار المشترك هو FUND ثم نقطتان رأسيتان ثم رمز التداول، مثل FUND:VFIAX. ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد. معرّف سهم على مسار الصناديق يعيد 404 not_found، ومعرّف صندوق على مسار الأسهم يُحوَّل إلى هنا برمز 301.

لصندوق ETF سعر. أما صندوق الاستثمار المشترك فله صافي قيمة أصول (NAV) مرة واحدة في اليوم، في الحقول nav وprevious_nav وdate. وتحمل إجابة السعر حقل type يبيّن لك أيهما حصلت عليه.

عنوان URL الأساسي: https://api.narwhalapi.com. أداة MCP هي funds, with one action لكل مسار أدناه.

ما يحصل عليه كل حساب

ما	كل حساب
آخر سعر لصندوق ETF	مباشر
صافي قيمة أصول صندوق الاستثمار المشترك (NAV)	آخر صافي قيمة أصول (NAV)
الشموع اليومية والتوزيعات السابقة	السجل التاريخي الكامل
شموع الدقيقة الواحدة (لصناديق ETF فقط)	مشمول
البحث والملف التعريفي	مشمول

راجع التسعير لمعرفة تكلفة الاستدعاء. يُحاسَب الطلب بسعر واجهته ما لم يذكر المسار خلاف ذلك.

صافي قيمة أصول صندوق الاستثمار المشترك قيمة نهاية اليوم ولا يتأخر أبدًا. ويُعدّ قديمًا (stale) إذا تجاوز عمره يوم العمل التالي.
لا توجد لصندوق الاستثمار المشترك شموع بدقيقة واحدة. وطلبها يعيد 400 invalid_interval.
شمعة صندوق الاستثمار المشترك اليومية هي صافي قيمة أصوله (NAV): الافتتاح والأعلى والأدنى والإغلاق رقم واحد، ولا يوجد حجم تداول.
يُحذف الحقل kind من التوزيع إلى أن تقدّمه مصادرنا.

نقاط النهاية

كل مسار هو طلب GET ويحتاج إلى مفتاحك في: Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

البحث في صناديق ETF وصناديق الاستثمار المشتركة برمز التداول أو الاسم

GET /v1/funds/search

الصناديق التي يبدأ رمز تداولها أو اسمها بـ q، بأي حالة أحرف: رمز التداول المطابق تمامًا أولًا، ثم رموز التداول الأخرى، ثم الأسماء. مرشحان اختياريان: type (etf أو mutual_fund) وcountry (ثلاثة أحرف). حتى 50 نتيجة في الصفحة، مع next_cursor. تُقرأ من قائمة الرموز لدينا، فهي متاحة لكل حساب وتُحسب استدعاءً واحدًا.

MCP: الأداة funds, action search.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`q`	استعلام	نعم	سلسلة نصية	بداية رمز تداول أو اسم صندوق، بأي حالة أحرف، وبحرفين على الأقل (مثل `vf` أو `vanguard 500`). الترتيب: رمز التداول المطابق تمامًا، ثم رموز التداول الأخرى، ثم بداية الاسم، ثم بداية كلمة لاحقة في الاسم.
`country`	استعلام	لا	سلسلة نصية	صناديق هذا البلد فقط، بثلاثة أحرف (USA).
`type`	استعلام	لا	إحدى القيم: etf, mutual_fund	صناديق ETF فقط أو صناديق الاستثمار المشتركة فقط.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`results`	قائمة كائنات	دائمًا	50 نتيجة في الصفحة كحد أقصى.
`results[].id`	سلسلة نصية	دائمًا	معرّف الصندوق القياسي.
`results[].symbol`	سلسلة نصية	دائمًا	رمز تداول الصندوق.
`results[].name`	سلسلة نصية	دائمًا	الاسم كما تحتفظ به قائمة الرموز لدينا.
`results[].type`	إحدى القيم: etf, mutual_fund	دائمًا	نوع الأداة.
`results[].mic`	سلسلة نصية	اختياري	رمز البورصة المكوّن من أربعة أحرف. يُحذف لصندوق الاستثمار المشترك (لا بورصة له).
`results[].country`	سلسلة نصية	اختياري	بلد الصندوق، بثلاثة أحرف.
`results[].currency`	سلسلة نصية	دائمًا	عملة الأسعار.
`next_cursor`	سلسلة نصية	دائمًا	أعد إرساله لقراءة الصفحة التالية. تكون قيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/search?q=vanguard&type=mutual_fund"

{
  "results": [
    {
      "id": "ARCX:SPY",
      "symbol": "SPY",
      "name": "SPDR S&P 500 ETF Trust",
      "type": "etf",
      "mic": "ARCX",
      "country": "USA",
      "currency": "USD"
    },
    {
      "id": "FUND:VFIAX",
      "symbol": "VFIAX",
      "name": "Vanguard 500 Index Fund Admiral Shares",
      "type": "mutual_fund",
      "country": "USA",
      "currency": "USD"
    }
  ],
  "next_cursor": null
}

ملف تعريف صندوق واحد

GET /v1/funds/{id}

رمز الصندوق واسمه ونوعه (etf أو mutual_fund) وبورصته (لصناديق ETF فقط) وبلده وعملته، كما تحتفظ بها قائمة الرموز لدينا. متاح لكل حساب. تُحذف الحقول غير المعروفة.

MCP: الأداة funds, action profile.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`id`	مسار	نعم	سلسلة نصية	معرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الصندوق القياسي.
`symbol`	سلسلة نصية	دائمًا	رمز تداول الصندوق.
`name`	سلسلة نصية	دائمًا	الاسم كما تحتفظ به قائمة الرموز لدينا.
`type`	إحدى القيم: etf, mutual_fund	دائمًا	نوع الأداة.
`mic`	سلسلة نصية	اختياري	رمز البورصة المكوّن من أربعة أحرف. يُحذف لصندوق الاستثمار المشترك (لا بورصة له).
`country`	سلسلة نصية	اختياري	بلد الصندوق، بثلاثة أحرف.
`currency`	سلسلة نصية	دائمًا	عملة الأسعار.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY"

{
  "id": "ARCX:SPY",
  "symbol": "SPY",
  "name": "SPDR S&P 500 ETF Trust",
  "type": "etf",
  "mic": "ARCX",
  "country": "USA",
  "currency": "USD"
}

آخر سعر لصندوق واحد

GET /v1/funds/{id}/price

آخر سعر لصندوق ETF بشكل سعر السهم مضافًا إليه type: etf، أو آخر صافي قيمة أصول (NAV) لصندوق استثمار مشترك (type: mutual_fund: الحقول nav وprevious_nav وchange وchange_percent وdate الخاص بصافي القيمة؛ وهي قيمة نهاية اليوم ولا تتأخر أبدًا، وتصبح stale إذا تجاوز عمرها يوم العمل التالي). change_percent بالنسبة المئوية. معرّف السهم يعيد 404 not_found.

MCP: الأداة funds, action price.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`id`	مسار	نعم	سلسلة نصية	معرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الرمز المُدرج المعتمد.
`symbol`	سلسلة نصية	دائمًا	رمز التداول في تلك البورصة.
`currency`	سلسلة نصية	دائمًا	عملة كل حقول الأسعار. يُحوَّل البنس إلى جنيه.
`price`	سلسلة نصية	اختياري	آخر سعر، بوحدة `currency`.
`previous_close`	سلسلة نصية	اختياري	إغلاق الجلسة السابقة. يُحذف عند عدم معرفته.
`change`	سلسلة نصية	اختياري	`price` ناقص `previous_close`. يُحذف مع `previous_close`.
`change_percent`	سلسلة نصية	اختياري	التغير منذ `previous_close`، بالنسبة المئوية (1.5 تعني 1.5%).
`volume`	سلسلة نصية	اختياري	عدد الأسهم المتداولة اليوم. يُحذف عند عدم معرفته، ويُحذف دائمًا في الاستجابة المتأخرة.
`market_session`	إحدى القيم: pre, open, post, closed	اختياري	حالة بورصة الرمز المُدرج عند `timestamp`: pre أو open أو post أو closed. البورصات الأمريكية وحدها لها pre وpost.
`timestamp`	تاريخ ووقت	اختياري	وقت صلاحية السعر (بالتوقيت العالمي UTC، بالثواني الكاملة).
`stale`	منطقي	دائمًا	تكون القيمة true عندما يكون السعر أقدم من 15 دقيقة أثناء فتح البورصة، أو عندما تعذر تحديثه. السوق المغلق لا يُعد قديمًا أبدًا.
`delayed`	دائمًا true	اختياري	لا يُرسل: الأسعار فورية لكل حساب.
`type`	إحدى القيم: etf, mutual_fund	دائمًا	etf لصندوق ETF، وmutual_fund لصندوق استثمار مشترك.
`nav`	سلسلة نصية	اختياري	صافي قيمة الأصول للوحدة الواحدة، بعملة `currency`.
`previous_nav`	سلسلة نصية	اختياري	صافي قيمة الأصول لليوم السابق. يُحذف إذا لم يكن معروفًا.
`date`	التاريخ	اختياري	اليوم الذي يخصه صافي قيمة الأصول (YYYY-MM-DD).

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY/price"

{
  "id": "ARCX:SPY",
  "symbol": "SPY",
  "currency": "USD",
  "price": "578.12",
  "previous_close": "576.40",
  "change": "1.72",
  "change_percent": "0.30",
  "volume": "61230500",
  "market_session": "open",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false,
  "type": "etf"
}

آخر أسعار حتى 50 صندوقًا

GET /v1/funds/prices

آخر سعر لكل صندوق مذكور: آخر سعر لصندوق ETF أو آخر صافي قيمة أصول (NAV) لصندوق استثمار مشترك. يُحتسب استدعاء واحد لكل معرّف يعيد سعرًا، ويُخصم في خطوة واحدة: إذا لم يكفِ رصيدك لتغطية المعرّفات التي تم حلّها، يُرفض الطلب كله مع 402 insufficient_credits. المعرّفات التي لا تعيد سعرًا تُدرج في errors ولا تُكلّف شيئًا. change_percent بالنسبة المئوية.

أرسل حتى 50 معرّفًا، من صناديق ETF وصناديق الاستثمار المشتركة معًا. تُحاسَب الدفعة في خطوة واحدة: إذا لم يكفِ رصيدك لتغطية المعرّفات التي يتم حلّها، يعيد الطلب كله 402 insufficient_credits.

MCP: الأداة funds, action prices.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`ids`	استعلام	نعم	سلسلة نصية	معرّفات صناديق مفصولة بفواصل، بحد أقصى 50 بعد حذف المكرر. يخضع كل معرّف لقواعد مسار السعر الواحد نفسها. يُحتسب استدعاء واحد لكل معرّف يعيد سعرًا.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`prices`	قائمة كائنات	دائمًا	سعر واحد لكل معرّف تم حله، مفهرسًا بالمعرّف.
`prices[].id`	سلسلة نصية	دائمًا	معرّف الرمز المُدرج المعتمد.
`prices[].symbol`	سلسلة نصية	دائمًا	رمز التداول في تلك البورصة.
`prices[].currency`	سلسلة نصية	دائمًا	عملة كل حقول الأسعار. يُحوَّل البنس إلى جنيه.
`prices[].price`	سلسلة نصية	اختياري	آخر سعر، بوحدة `currency`.
`prices[].previous_close`	سلسلة نصية	اختياري	إغلاق الجلسة السابقة. يُحذف عند عدم معرفته.
`prices[].change`	سلسلة نصية	اختياري	`price` ناقص `previous_close`. يُحذف مع `previous_close`.
`prices[].change_percent`	سلسلة نصية	اختياري	التغير منذ `previous_close`، بالنسبة المئوية (1.5 تعني 1.5%).
`prices[].volume`	سلسلة نصية	اختياري	عدد الأسهم المتداولة اليوم. يُحذف عند عدم معرفته، ويُحذف دائمًا في الاستجابة المتأخرة.
`prices[].market_session`	إحدى القيم: pre, open, post, closed	اختياري	حالة بورصة الرمز المُدرج عند `timestamp`: pre أو open أو post أو closed. البورصات الأمريكية وحدها لها pre وpost.
`prices[].timestamp`	تاريخ ووقت	اختياري	وقت صلاحية السعر (بالتوقيت العالمي UTC، بالثواني الكاملة).
`prices[].stale`	منطقي	دائمًا	تكون القيمة true عندما يكون السعر أقدم من 15 دقيقة أثناء فتح البورصة، أو عندما تعذر تحديثه. السوق المغلق لا يُعد قديمًا أبدًا.
`prices[].delayed`	دائمًا true	اختياري	لا يُرسل: الأسعار فورية لكل حساب.
`prices[].type`	إحدى القيم: etf, mutual_fund	دائمًا	etf لصندوق ETF، وmutual_fund لصندوق استثمار مشترك.
`prices[].nav`	سلسلة نصية	اختياري	صافي قيمة الأصول للوحدة الواحدة، بعملة `currency`.
`prices[].previous_nav`	سلسلة نصية	اختياري	صافي قيمة الأصول لليوم السابق. يُحذف إذا لم يكن معروفًا.
`prices[].date`	التاريخ	اختياري	اليوم الذي يخصه صافي قيمة الأصول (YYYY-MM-DD).
`errors`	قائمة كائنات	دائمًا	المعرّفات التي لم تعد سعرًا. لا تُحتسب عليها رسوم.
`errors[].id`	سلسلة نصية	دائمًا	المعرّف كما طُلب.
`errors[].code`	إحدى القيم: not_found, not_covered, upstream_busy	دائمًا	not_found: لا يوجد رمز مُدرج بهذا المعرّف. not_covered: لا أسعار لهذه البورصة بعد. upstream_busy: تعذر جلب السعر الآن، فأعد المحاولة بعد قليل.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/prices?ids=ARCX:SPY,FUND:VFIAX"

{
  "prices": [
    {
      "id": "ARCX:SPY",
      "symbol": "SPY",
      "currency": "USD",
      "price": "578.12",
      "previous_close": "576.40",
      "change": "1.72",
      "change_percent": "0.30",
      "volume": "61230500",
      "market_session": "open",
      "timestamp": "2026-10-26T15:42:00Z",
      "stale": false,
      "type": "etf"
    },
    {
      "id": "FUND:VFIAX",
      "symbol": "VFIAX",
      "currency": "USD",
      "type": "mutual_fund",
      "nav": "551.07",
      "previous_nav": "549.80",
      "change": "1.27",
      "change_percent": "0.23",
      "date": "2026-10-23",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "FUND:NOPE",
      "code": "not_found"
    }
  ]
}

شموع أسعار صندوق واحد

GET /v1/funds/{id}/bars

شموع يومية (1d) أو بدقيقة واحدة (1m)، الأقدم أولًا، بشكل شموع الأسهم. الشمعة اليومية لصندوق الاستثمار المشترك هي صافي قيمة أصوله اليومي (الافتتاح والأعلى والأدنى والإغلاق كلها صافي القيمة، بلا حجم تداول)؛ ولا توجد له شموع بدقيقة واحدة (400 invalid_interval). شموع الدقيقة الواحدة لصناديق ETF فقط. السجل التاريخي: كامله، لكل حساب. حتى 5,000 شمعة في الصفحة، مع next_cursor؛ والمؤشر الذي لم يعد يطابق الأسعار يعيد 409 cursor_expired. استدعاء واحد لكل صفحة.

إذا غيّر تجزئة أو توزيع السجل التاريخي بين صفحتين، يتوقف المؤشر عن العمل ويعيد 409 cursor_expired.

MCP: الأداة funds, action bars.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`id`	مسار	نعم	سلسلة نصية	معرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
`interval`	استعلام	لا	إحدى القيم: 1d, 1m	`1d` (شمعة واحدة لكل جلسة؛ وشمعة صندوق الاستثمار المشترك هي صافي قيمة أصوله اليومي) أو `1m` (شموع الدقيقة الواحدة: لصناديق ETF فقط). أي قيمة أخرى تعيد 400 invalid_interval.
`start`	استعلام	لا	سلسلة نصية	أول شمعة. `1d`: تاريخ (YYYY-MM-DD)، شاملًا؛ وحذفه يعني أقدم شمعة متاحة. `1m`: وقت بتوقيت UTC (YYYY-MM-DDTHH:MM:SSZ، أو تاريخ للدلالة على 00:00 UTC)، شاملًا؛ وحذفه يعني يومًا واحدًا قبل `end`.
`end`	استعلام	لا	سلسلة نصية	آخر شمعة. `1d`: تاريخ، شاملًا؛ وحذفه يعني أحدث جلسة صدرت شمعتها. `1m`: وقت بتوقيت UTC، غير شامل؛ وحذفه يعني الآن، أو بعد خمسة أيام من `start`. الحد الأقصى 5 أيام بين `start` و`end` للقيمة `1m` (400 range_too_large).
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها. يتوقف المؤشر عن العمل عندما تتغير الأسعار التي يستند إليها (تجزئة أو توزيعة): 409 cursor_expired.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الرمز المُدرج المعتمد.
`currency`	سلسلة نصية	دائمًا	عملة كل سعر. يتحول البنس إلى جنيه.
`adjusted`	منطقي	دائمًا	دائمًا true: الأسعار معدّلة لتجزئات الأسهم والتوزيعات. تتفق الصفحة والتي تليها دائمًا؛ وإذا غيّرت تجزئة أو توزيعة السجل بين صفحتين، يتوقف المؤشر عن العمل (409 cursor_expired) بدلًا من خلط الاثنتين.
`start`	سلسلة نصية	اختياري	لا يُرسل أبدًا: لا يُنقل `start`.
`end`	سلسلة نصية	اختياري	لا يُرسل أبدًا: لا تُقتطع الشموع اليومية.
`bars`	قائمة كائنات	دائمًا	5,000 شمعة في الصفحة كحد أقصى.
`bars[].date`	سلسلة نصية	اختياري	تاريخ الجلسة (YYYY-MM-DD). للشموع اليومية فقط؛ ويُحذف في شموع الدقيقة الواحدة.
`bars[].timestamp`	تاريخ ووقت	دائمًا	بداية فترة الشمعة (UTC): افتتاح البورصة للشمعة اليومية، والدقيقة لشمعة الدقيقة الواحدة.
`bars[].open`	سلسلة نصية	دائمًا	أول سعر في الفترة.
`bars[].high`	سلسلة نصية	دائمًا	أعلى سعر في الفترة.
`bars[].low`	سلسلة نصية	دائمًا	أدنى سعر في الفترة.
`bars[].close`	سلسلة نصية	دائمًا	آخر سعر في الفترة.
`bars[].volume`	سلسلة نصية	اختياري	عدد الأسهم المتداولة في الفترة. يُحذف عند عدم معرفته.
`next_cursor`	سلسلة نصية	دائمًا	أعد إرساله لقراءة الصفحة التالية. تكون قيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY/bars?interval=1d&start=2026-10-01"

{
  "id": "ARCX:SPY",
  "currency": "USD",
  "adjusted": true,
  "bars": [
    {
      "date": "2026-10-23",
      "timestamp": "2026-10-23T13:30:00Z",
      "open": "575.10",
      "high": "577.60",
      "low": "573.90",
      "close": "576.40",
      "volume": "48210300"
    }
  ],
  "next_cursor": null
}

توزيعات صندوق واحد

GET /v1/funds/{id}/distributions

توزيعات صندوق واحد، الأحدث تاريخ استحقاق أولًا، على صفحات. يحصل كل حساب على السجل الكامل. كل طلب يُحتسب استدعاءً واحدًا. المعرّف غير المعروف يعيد 404 not_found.

MCP: الأداة funds, action distributions.

المعلمات

معلمة	الموضع	مطلوب	النوع	المعنى
`id`	مسار	نعم	سلسلة نصية	معرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
`cursor`	استعلام	لا	سلسلة نصية	قيمة `next_cursor` من الصفحة السابقة، مع المعاملات الأخرى نفسها.

حقول الاستجابة

حقل	النوع	يُرسل	المعنى
`id`	سلسلة نصية	دائمًا	معرّف الصندوق القياسي.
`start`	التاريخ	اختياري	لا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.
`distributions`	قائمة كائنات	دائمًا	الأحدث تاريخ استحقاق أولًا.
`distributions[].ex_date`	التاريخ	دائمًا	أول يوم يُتداول فيه الصندوق دون التوزيع.
`distributions[].amount`	سلسلة نصية	دائمًا	التوزيع للوحدة الواحدة، بعملة `currency`.
`distributions[].currency`	سلسلة نصية	دائمًا	عملة `amount`.
`distributions[].pay_date`	التاريخ	اختياري	يوم الدفع. يُحذف عند عدم معرفته.
`distributions[].record_date`	التاريخ	اختياري	اليوم الذي يجب أن يكون فيه المالك مسجلًا. يُحذف عند عدم معرفته.
`distributions[].kind`	إحدى القيم: income, capital_gain	اختياري	نوع التوزيع. يُحذف حيث لا يذكره المصدر.
`next_cursor`	سلسلة نصية	دائمًا	مرّره كقيمة `cursor` للصفحة التالية؛ وتكون قيمته null في الصفحة الأخيرة.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/funds/ARCX:SPY/distributions"

{
  "id": "ARCX:SPY",
  "distributions": [
    {
      "ex_date": "2026-09-18",
      "amount": "1.78",
      "currency": "USD",
      "pay_date": "2026-10-30",
      "record_date": "2026-09-18"
    }
  ],
  "next_cursor": null
}

الأخطاء

تستخدم الأخطاء بنية المشكلة المشتركة مع: request_id. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.

الرمز	الحالة	المعنى
`invalid_query`	400	معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
`invalid_id`	400	معرّف أو زوج غير مكتوب بالصيغة التي تتوقعها هذه الواجهة.
`too_many_ids`	400	تحتوي الدفعة على أكثر من 50 معرّفًا.
`invalid_interval`	400	الفاصل الزمني ليس 1d ولا 1m، أو غير متاح لهذه الأداة.
`range_too_large`	400	النافذة أطول مما يسمح به المسار.
`not_found`	404	لا يوجد رمز مُدرج أو صندوق أو زوج بهذا المعرّف.
`invalid_cursor`	400	مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
`cursor_expired`	409	تغيرت الأسعار التي يقوم عليها المؤشر. ابدأ من جديد دون المؤشر.
`insufficient_credits`	402	رصيدك أقل من تكلفة الطلب.
`upstream_busy`	503	تعذّر جلب السعر الآن. وفي الدفعة يُدرج في errors. حاول مجددًا بعد قليل.
`area_unavailable`	503	هذا القسم لا يستطيع الإجابة الآن.

هل كانت هذه الصفحة مفيدة؟