جميع واجهات API

API المؤشرات

احصل على آخر مستوى والإغلاق السابق وتاريخ يومي أو بدقيقة واحدة لـ 18 مؤشرًا عبر REST أو MCP. المستويات سلاسل نصية عشرية.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←

الطلب الأول

الحصول على آخر مستوى لمؤشر S&P 500

curl --request GET \
  --url "https://api.narwhalapi.com/v1/indices/SPX/price" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "id": "SPX",
  "name": "S&P 500",
  "currency": "USD",
  "price": "7696.46",
  "previous_close": "7681.2",
  "change": "15.26",
  "change_percent": "0.2",
  "market_session": "open",
  "timestamp": "2026-10-29T18:38:00Z",
  "stale": false
}

نقاط النهاية

GETعرض المؤشرات/v1/indices

اعرض كل مؤشر نسعّره، مع اسمه ومنطقته وعملته.

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

  • indicesقائمة كائنات

    كل مؤشر نسعّره، مع معرّفه واسمه ومنطقته وعملته.

المرجع الكامل ‏←
GETالحصول على سعر مؤشر/v1/indices/{id}/price

احصل على آخر مستوى لمؤشر واحد، مع الإغلاق السابق والتغير.

المعلمات

  • idمطلوب

    معرّف المؤشر، مثل SPX أو NDX أو DJI. تصلح أي حالة أحرف.

حقول الاستجابة الرئيسية

  • idسلسلة نصية

    رمز المؤشر، مثل SPX.

  • nameسلسلة نصية

    الاسم الرسمي للمؤشر.

  • currencyسلسلة نصية

    عملة المؤشر. تُحذف في مؤشر التقلب.

  • priceسلسلة نصية

    آخر مستوى للمؤشر، كسلسلة نصية عشرية.

  • previous_closeسلسلة نصية

    إغلاق يوم التداول السابق. يُحذف عندما لا يكون معروفًا.

  • changeسلسلة نصية

    price مطروحًا منه previous_close. يُحذف مع previous_close.

  • change_percentسلسلة نصية

    التغير بالنسبة المئوية: 1.5 تعني 1.5%. يُحذف مع change.

  • market_sessionإحدى القيم: open, closed

    open ما دام المؤشر يُتداول وفق ساعاته المنشورة، وإلا فـ closed.

  • timestampتاريخ ووقت

    وقت صلاحية السعر، بالتوقيت العالمي UTC بثوانٍ كاملة.

  • staleمنطقي

    تكون القيمة true عندما يكون المؤشر مفتوحًا ويزيد عمر مستواه على 15 دقيقة. المؤشر المغلق لا يكون قديمًا أبدًا.

المرجع الكامل ‏←
GETالحصول على عدة أسعار للمؤشرات/v1/indices/prices

احصل على آخر مستويات ما يصل إلى 50 مؤشرًا في استدعاء واحد.

المعلمات

  • idsمطلوب

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

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

  • pricesقائمة كائنات

    عنصر واحد لكل معرّف أعاد سعرًا، بحقول السعر الفردي نفسها.

  • errorsقائمة كائنات

    المعرّفات التي لم تُرجع سعرًا، لكل منها الرمز not_found. وهي مجانية.

المرجع الكامل ‏←
GETالحصول على أشرطة المؤشر/v1/indices/{id}/bars

احصل على أشرطة يومية أو بدقيقة واحدة لمؤشر واحد، من الأقدم إلى الأحدث.

المعلمات

  • idمطلوب

    معرّف المؤشر، مثل SPX أو NDX أو DJI. تصلح أي حالة أحرف.

  • intervalاختياري

    1d (شريط واحد لكل يوم تداول، مؤرخ باليوم الذي ينتمي إليه) أو 1m (أشرطة بدقيقة واحدة، تُحفظ 12 شهراً). أي قيمة أخرى تُرجع 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 من الصفحة السابقة، مع المعاملات نفسها.

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

  • idسلسلة نصية

    رمز المؤشر، مثل SPX.

  • currencyسلسلة نصية

    عملة المؤشر. تُحذف في مؤشر التقلب.

  • startسلسلة نصية

    يُرسل فقط عندما يُنقل بدء النطاق إلى الأمام.

  • endسلسلة نصية

    لا يُرسل، لأن الأسعار مباشرة لكل حساب.

  • barsقائمة كائنات

    الأشرطة من الأقدم إلى الأحدث. يحتوي كل منها على timestamp وopen وhigh وlow وclose، ولا يحتوي على حجم تداول.

  • next_cursorسلسلة نصية

    أعد إرساله لقراءة الصفحة التالية. تكون قيمته null في الصفحة الأخيرة.

المرجع الكامل ‏←

حالات الاستخدام

استرجع تاريخاً كاملاً

اقرأ كل السجل صفحة بصفحة واحفظه في ملف واستأنف إذا توقف.

اقرأ الدليل ‏←

سحب يومي للبيانات

شغّل سكربتًا صغيرًا مرة في اليوم وأضف النتيجة إلى ملف CSV.

اقرأ الدليل ‏←

التخزين المؤقت وأخطاء 429

Cache responses by data type and tell a rate limit (429) from an empty credit balance (402).

اقرأ الدليل ‏←

التغطية

  • S&P 500SPX · الولايات المتحدة · USD
  • Nasdaq-100NDX · الولايات المتحدة · USD
  • مؤشر داو جونز الصناعيDJI · الولايات المتحدة · USD
  • راسل 2000RUT · الولايات المتحدة · USD
  • مؤشر ناسداك المركبCOMP · الولايات المتحدة · USD
  • مؤشر Cboe للتقلبVIX · الولايات المتحدة
  • MSCI العالميMXWLD · عالمي · USD
  • MSCI للأسواق الناشئةMXEF · عالمي · USD
  • Cboe UK 100BUK100P · UK · GBP
  • Cboe Germany 40BDE40P · أوروبا · EUR
  • Cboe Europe 50BEP50P · أوروبا · EUR
  • Cboe Eurozone 50BEZ50P · أوروبا · EUR
عرض جميع المؤشرات (18)
  • Cboe France 40BFR40P · أوروبا · EUR
  • PHLX لقطاع أشباه الموصلاتSOX · الولايات المتحدة · USD
  • KBW ناسداك للبنوكBKX · الولايات المتحدة · USD
  • مؤشر Cboe لتقلب صندوق النفط الخام المتداولOVX · الولايات المتحدة
  • مؤشر Cboe لتقلب صندوق الذهب المتداولGVZ · الولايات المتحدة
  • PHLX لقطاع الذهب والفضةXAU · الولايات المتحدة · USD

واجهات API ذات صلة

futures API لبيانات العقود الآجلة

الأسعار والتاريخ لـ 29 عقدًا آجلًا عبر REST وMCP

استكشف API ‏←

API الأسهم المدرجة

أسعار الأسهم المدرجة وبيانات الشركات عبر REST وMCP

استكشف API ‏←

الأسعار

رصيد مجاني بقيمة 10 دولارات شهريًا، ثم ابتداءً من 2 دولار لكل 1,000 استدعاء.

عرض الأسعار ‏←

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

ما المؤشرات التي يمكنني الحصول عليها؟

18 مؤشرًا: خمسة مؤشرات أمريكية رئيسية، وثلاثة مؤشرات تقلب، ومؤشران عالميان من MSCI، وخمسة مؤشرات Cboe الأوروبية، وثلاثة مؤشرات لقطاعات أمريكية. المعرّف هو الرمز القياسي، مثل SPX أو NDX أو DJI، بأي حالة أحرف.

هل يأتي المستوى مع التغير عن أمس؟

نعم. يحمل السعر previous_close وchange وchange_percent بمجرد توفر التاريخ اليومي للمؤشر. تعني change_percent بقيمة 1.5 النسبة 1.5%. تُحذف الثلاثة جميعًا عندما لا يكون الإغلاق السابق معروفًا.

لماذا لا تكون لمؤشر التقلب عملة؟

يقيس VIX وOVX وGVZ التقلب المتوقع لا المال، لذلك لا تحتوي إجاباتها على عملة.

هل المستويات مباشرة أم متأخرة؟

المستويات مباشرة لكل حساب. عندما يكون السوق مغلقًا، تُجيب الواجهة بآخر مستوى وmarket_session بقيمة closed.

ما مقدار التاريخ الذي يمكنني الحصول عليه؟

يبدأ التاريخ من حيث نحتفظ به: يبدأ S&P 500 في فبراير 2023. يحصل كل حساب على الشموع اليومية لكل ما نحتفظ به. تغطي شموع الدقيقة الواحدة آخر 12 شهرًا وتمتد إلى 5 أيام كحد أقصى في الطلب الواحد.

كم التكلفة؟

تكلفة الاستدعاءات 2 دولار لكل 1,000 استدعاء من رصيد الائتمان المدفوع مسبقًا. يحصل كل حساب على 10 دولارات من الرصيد المجاني كل شهر خلال أول 12 شهرًا.