استرجع تاريخاً كاملاً
اقرأ كل السجل صفحة بصفحة واحفظه في ملف واستأنف إذا توقف.
اقرأ الدليل ←جميع واجهات API
API الصناديق المتداولة وصافي قيمة الأصول
احصل على أسعار وتاريخ أسعار صناديق ETF والصناديق المشتركة، مع البحث والملفات التعريفية في كل حساب. يحتاج كل طلب إلى مفتاح Bearer؛ يشترك REST وMCP في رصيد حساب واحد.
الطلب الأول
احصل على آخر سعر
curl --request GET \
--url "https://api.narwhalapi.com/v1/funds/ARCX:SPY/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية
{
"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"
}نقاط النهاية
GETالبحث في صناديق ETF وصناديق الاستثمار المشتركة برمز التداول أو الاسم/v1/funds/search
الصناديق التي يبدأ رمزها أو اسمها بالحرف q بأي حالة: الرمز المطابق تماماً أولاً، ثم الرموز الأخرى، ثم الأسماء.
المعلمات
qمطلوببداية رمز أو اسم صندوق، بأي حالة، وبحد أدنى حرفان (مثل vf أو vanguard 500). الترتيب: الرمز المطابق تماماً، ثم الرموز الأخرى، ثم بداية الاسم، ثم بداية كلمة لاحقة من الاسم.
countryاختياريصناديق هذا البلد فقط، بثلاثة أحرف (USA).
typeاختياريصناديق ETF فقط أو صناديق الاستثمار المشتركة فقط.
cursorاختياريقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.
حقول الاستجابة
resultsقائمة كائنات50 نتيجة في الصفحة كحد أقصى.
next_cursorسلسلة نصيةأعد إرساله لقراءة الصفحة التالية. تكون قيمته null في الصفحة الأخيرة.
المرجع الكامل ←
GETملف تعريف صندوق واحد/v1/funds/{id}
رمز الصندوق واسمه ونوعه (etf أو mutual_fund) وبورصته (للصناديق المتداولة ETF فقط) ودولته وعملته، كما تحتفظ بها قائمة الرموز لدينا.
المعلمات
idمطلوبمعرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
حقول الاستجابة
idسلسلة نصيةمعرّف الصندوق القياسي.
symbolسلسلة نصيةرمز تداول الصندوق.
micسلسلة نصيةرمز البورصة المكوّن من أربعة أحرف. يُحذف لصندوق الاستثمار المشترك (لا بورصة له).
countryسلسلة نصيةبلد الصندوق، بثلاثة أحرف.
المرجع الكامل ←
GETآخر سعر لصندوق واحد/v1/funds/{id}/price
آخر سعر لصندوق متداول ETF، بشكل سعر السهم مع النوع type: etf، أو أحدث صافي قيمة أصول لصندوق مشترك (type: mutual_fund: وفيه nav وprevious_nav وchange وchange_percent وتاريخ صافي القيمة؛ وهي قيمة نهاية اليوم، لا تتأخر أبداً، وتصبح قديمة عندما يتجاوز عمرها يوم العمل التالي).
المعلمات
idمطلوبمعرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
حقول الاستجابة الرئيسية
idسلسلة نصيةمعرّف الإدراج المعتمد الذي أُعيد للصندوق المطلوب.
symbolسلسلة نصيةالرمز المختصر المستخدم لهذا الصندوق في بورصته.
currencyسلسلة نصيةعملة كل حقل سعر، مع تحويل البنسات إلى جنيهات.
priceسلسلة نصيةآخر سعر لـ ETF، يُعاد كسلسلة نصية بعملة currency.
previous_closeسلسلة نصيةإغلاق الجلسة السابقة، ويُحذف عندما تكون هذه القيمة غير معروفة.
changeسلسلة نصيةETF: price مطروحًا منه previous_close؛ الصندوق المشترك: nav مطروحًا منه previous_nav. يُحذف عندما تكون القيمة السابقة غير معروفة.
change_percentسلسلة نصيةنسبة التغير المئوية عن previous_close لصناديق ETF أو previous_nav للصناديق المشتركة؛ 1.5 تعني 1.5%. تُحذف عندما تكون القيمة السابقة غير معروفة.
volumeسلسلة نصيةالأسهم المتداولة اليوم، وتُحذف عند عدم معرفتها.
market_sessionإحدى القيم: pre, open, post, closedحالة البورصة عند timestamp: pre أو open أو post أو closed؛ وحدها البورصات الأمريكية لها pre وpost.
timestampتاريخ ووقتوقت صلاحية السعر، بالتوقيت العالمي UTC بثوانٍ كاملة.
المرجع الكامل ←
GETآخر أسعار حتى 50 صندوقًا/v1/funds/prices
أحدث سعر لكل صندوق مُدرج: آخر سعر لصندوق متداول ETF أو أحدث صافي قيمة أصول لصندوق مشترك.
المعلمات
idsمطلوبمعرّفات صناديق مفصولة بفواصل، بحد أقصى 50 بعد حذف المكرر. يخضع كل معرّف لقواعد مسار السعر الواحد نفسها. يُحتسب استدعاء واحد لكل معرّف يعيد سعرًا.
حقول الاستجابة
pricesقائمة كائناتسعر واحد لكل معرّف تم حله، مفهرسًا بالمعرّف.
errorsقائمة كائناتالمعرّفات التي لم تعد سعرًا. لا تُحتسب عليها رسوم.
المرجع الكامل ←
GETشموع أسعار صندوق واحد/v1/funds/{id}/bars
أشرطة يومية (1d) أو بدقيقة واحدة (1m)، من الأقدم إلى الأحدث، بشكل شريط السهم.
المعلمات
idمطلوبمعرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
intervalاختياري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 شمعة في الصفحة كحد أقصى.
next_cursorسلسلة نصيةأعد إرساله لقراءة الصفحة التالية. تكون قيمته null في الصفحة الأخيرة.
المرجع الكامل ←
GETتوزيعات صندوق واحد/v1/funds/{id}/distributions
توزيعات صندوق واحد، من الأحدث تاريخ استحقاق (ex-date)، مع ترقيم الصفحات.
المعلمات
idمطلوبمعرّف الصندوق. صندوق ETF معرّفه هو معرّف رمزه المُدرج: رمز البورصة المكوّن من أربعة أحرف ثم نقطتان رأسيتان ثم رمز التداول (ARCX:SPY). وصندوق الاستثمار المشترك معرّفه FUND ثم نقطتان رأسيتان ثم رمز تداوله (FUND:VFIAX). ويصلح أيضًا رمز تداول أمريكي مجرد مثل SPY إذا كان يشير إلى رمز مُدرج أمريكي واحد؛ وتحمل الإجابة المعرّف القياسي.
cursorاختياري
حقول الاستجابة
idسلسلة نصيةمعرّف الصندوق القياسي.
startالتاريخلا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.
distributionsقائمة كائناتالأحدث تاريخ استحقاق أولًا.
next_cursorسلسلة نصيةمرّره كقيمة cursor للصفحة التالية؛ وهو null في الصفحة الأخيرة.
المرجع الكامل ←
حالات الاستخدام
سحب يومي للبيانات
شغّل سكربتًا صغيرًا مرة في اليوم وأضف النتيجة إلى ملف CSV.
اقرأ الدليل ←التخزين المؤقت وأخطاء 429
Cache responses by data type and tell a rate limit (429) from an empty credit balance (402).
اقرأ الدليل ←واجهات API ذات صلة
API الأسهم المدرجة
أسعار الأسهم المدرجة وبيانات الشركات عبر REST وMCP
استكشف API ←API العملات الرقمية للأسعار المباشرة والتاريخية
أسعار أزواج العملات المشفرة وتاريخها عبر REST وMCP
استكشف API ←الرصيد المدفوع مسبقًا والأسعار
اطلع على الأسعار لكل 1,000 استدعاء وعمليات الشحن والرصيد المجاني الشهري، مع أسعار مباشرة لكل حساب.
عرض الأسعار ←الأسئلة الشائعة
كيف أكتب معرّف صندوق ETF؟
استخدم معرّف إدراج ETF مثل ARCX:SPY. يعمل أيضًا الرمز الأمريكي المجرد مثل SPY عندما يدل على إدراج أمريكي واحد.
كيف أحصل على قيمة صندوق استثمار مشترك؟
استخدم FUND:VFIAX للصندوق المشترك. يظهر صافي قيمة أصوله اليومي في nav، مع previous_nav وdate؛ ولا تتأخر قيم الصناديق المشتركة أبدًا.
هل الأسعار مباشرة أم متأخرة؟
أسعار الأسهم وصناديق ETF والعملات المشفرة مباشرة في كل حساب، مع حجم اليوم عند معرفته.
كم التكلفة؟
تكلفة الاستدعاءات 2 دولار لكل 1,000 استدعاء من رصيد الائتمان المدفوع مسبقًا. يحصل كل حساب على 10 دولارات من الرصيد المجاني كل شهر خلال أول 12 شهرًا، والاستخدام التجاري مسموح.
ماذا تغطي الواجهة؟
تغطي الشموع اليومية والتوزيعات السابقة التاريخ الكامل لكل حساب، مع شموع ETF بدقيقة واحدة. لا توجد للصناديق المشتركة شموع بدقيقة واحدة؛ وتُرجع الطلبات 400 invalid_interval. تستخدم شموعها اليومية صافي القيمة للافتتاح والأعلى والأدنى والإغلاق، دون حجم. تقبل طلبات الأسعار الجماعية حتى 50 معرّفًا وتحتسب استدعاءً واحدًا لكل معرّف يُرجع سعرًا.
ما الفرق بين أسعار ETF وصافي قيم أصول الصناديق المشتركة؟
يعيد صندوق ETF سعرًا متداولًا. ويعيد الصندوق المشترك صافي قيمة أصول واحدًا في نهاية اليوم في nav، مع previous_nav وdate. اقرأ type لمعرفة etf أو mutual_fund. لا تتأخر قيم NAV أبدًا، وتصبح قديمة عندما يتجاوز عمرها يوم العمل التالي. أسعار ETF لا تكون قديمة أبدًا عندما تكون البورصة مغلقة.
ماذا يحدث عندما أستخدم نوعًا خاطئًا من المعرّفات؟
تستخدم معرّفات ETF رمز البورصة والرمز المختصر، مثل ARCX:SPY؛ وتستخدم معرّفات الصناديق المشتركة FUND متبوعًا بنقطتين رأسيتين والرمز المختصر. يعيد معرّف سهم على مسار صندوق الخطأ 404 not_found. ويُعاد توجيه معرّف صندوق على مسار سهم إلى مسار الصندوق برمز 301.
إلى أي مدى يمكنني طلب سجل الصناديق؟
يحصل كل حساب على التاريخ الكامل للشموع اليومية والتوزيعات السابقة. وإذا لم تتوفر صفوف أقدم، يُرجع start أول تاريخ تم تقديمه. يُحذف حقل kind في التوزيع إلى أن توفره المصادر.
كيف تُحتسب طلبات أسعار الصناديق؟
يستخدم REST وMCP حسابًا واحدًا ورصيدًا واحدًا، ويحتاج كل طلب إلى مفتاح Bearer. تقبل الدفعة حتى 50 معرّف صندوق وتحتسب استدعاءً واحدًا لكل معرّف يُرجع سعرًا.
ابدأ بمفتاح مجاني
رصيد مجاني بقيمة 10 دولارات كل شهر لمدة 12 شهرًا. لا حاجة إلى بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر. لا حاجة إلى بطاقة.