جميع واجهات API

API العملات الرقمية للأسعار المباشرة والتاريخية

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

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
متاح99.97% uptime, last 30 أيام1039 ms زمن الاستجابة المعتاد

الطلب الأول

احصل على آخر سعر

curl --request GET \
  --url "https://api.narwhalapi.com/v1/crypto/BTC-USD/price" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "pair": "BTC-USD",
  "base": "BTC",
  "quote": "USD",
  "price": "68250.5",
  "change_24h": "812.4",
  "change_24h_percent": "1.2",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false
}

نقاط النهاية

GETأزواج العملات الرقمية التي نسعّرها/v1/crypto/pairs

كل زوج نسعّره، حسب الزوج (بصيغة BTC-USD).

المعلمات

  • quoteاختياري

    الأزواج المسعّرة بهذه العملة فقط (USD أو EUR أو GBP).

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

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

    كل زوج نسعّره، مرتبًا حسب الزوج. يبقى الزوج في القائمة ما دام يُتداول مرة واحدة على الأقل كل 30 ثانية، ويُحذف إذا انخفض عن مرة كل دقيقتين.

المرجع الكامل ‏←
GETآخر سعر لزوج عملات رقمية واحد/v1/crypto/{pair}/price

أحدث سعر مركّب لزوج، مع تغيّر 24 ساعة (يُحذف عندما لا يكون معروفاً).

المعلمات

  • pairمطلوب

    زوج عملات رقمية: العملة الرقمية ثم شرطة ثم عملة التسعير، مثل BTC-USD أو ETH-EUR. تصلح أي حالة أحرف، ويُقبل الشرطة المائلة بدل الشرطة. تحمل الإجابة الزوج القياسي.

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

  • pairسلسلة نصية

    الزوج المعتمد الذي أُعيد مع العملة المشفرة وعملة التسعير.

  • baseسلسلة نصية

    الرمز المختصر للعملة المشفرة في زوج العملات المشفرة المطلوب.

  • quoteسلسلة نصية

    عملة التسعير المستخدمة لكل سعر في الاستجابة.

  • priceسلسلة نصية

    آخر سعر كسلسلة نصية عشرية، بما يصل إلى 8 أرقام معنوية.

  • change_24hسلسلة نصية

    تغيّر السعر خلال 24 ساعة، مشتق من نسبة التغيّر؛ يُحذف عند عدم معرفته.

  • change_24h_percentسلسلة نصية

    التغير خلال 24 ساعة بالنسبة المئوية؛ 1.5 تعني 1.5%. يُحذف مع change_24h.

  • timestampتاريخ ووقت

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

  • staleمنطقي

    تكون القيمة true عندما يتجاوز عمر السعر 5 دقائق أو تعذّر تحديثه.

  • delayedدائمًا true

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

المرجع الكامل ‏←
GETآخر أسعار حتى 50 زوج عملات رقمية/v1/crypto/prices

أحدث سعر لكل زوج مُدرج.

المعلمات

  • pairsمطلوب

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

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

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

    سعر واحد لكل زوج تم حلّه، مرتبًا حسب الزوج.

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

    الأزواج التي لم تعد سعرًا. لا تُحاسَب.

المرجع الكامل ‏←
GETشموع أسعار زوج عملات رقمية واحد/v1/crypto/{pair}/bars

أشرطة يومية (1d، يوم UTC واحد، تُغلق عند 00:00 UTC) أو بدقيقة واحدة (1m)، من الأقدم إلى الأحدث.

المعلمات

  • pairمطلوب

    زوج عملات رقمية: العملة الرقمية ثم شرطة ثم عملة التسعير، مثل BTC-USD أو ETH-EUR. تصلح أي حالة أحرف، ويُقبل الشرطة المائلة بدل الشرطة. تحمل الإجابة الزوج القياسي.

  • intervalاختياري

    1d (one bar لكل UTC day, closing at 00:00 UTC) or 1m (one-minute bars). Anything else is 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 من الصفحة السابقة، مع المعاملات نفسها.

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

  • pairسلسلة نصية

    الزوج القياسي.

  • startسلسلة نصية

    لا يُرسل أبداً: لا يتم تحريك start.

  • endسلسلة نصية

    لا يُرسل أبدًا: لا تُقتطع الشموع اليومية.

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

    5,000 شمعة في الصفحة كحد أقصى.

  • next_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 الصناديق المتداولة وصافي قيمة الأصول

أسعار ETF وصافي قيم الأصول اليومية للصناديق المشتركة

استكشف API ‏←

الرصيد المدفوع مسبقًا والأسعار

اطلع على الأسعار لكل 1,000 استدعاء وعمليات الشحن والرصيد المجاني الشهري، مع أسعار مباشرة لكل حساب.

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

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

ما الأزواج التي يمكنني الحصول عليها؟

يُسعَّر نحو 40 زوجًا مقابل USD وEUR وGBP. استخدم BTC-USD أو ETH-EUR؛ تقبل المعرّفات أي حالة أحرف أو الخط المائل، وتعيد الإجابات الأزواج المعتمدة.

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

أسعار الأسهم وصناديق ETF والعملات المشفرة مباشرة في كل حساب، وتتضمن إجابات العملات المشفرة تغيّر 24 ساعة.

ما مدى حداثة أسعار العملات المشفرة؟

تُتداول العملات المشفرة طوال اليوم دون جلسة سوق. تكون الأسعار قديمة عندما يتجاوز عمرها 5 دقائق أو يفشل التحديث؛ ولا تحتوي الأسعار والأشرطة على حقل حجم التداول.

كم التكلفة؟

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

ماذا تغطي الواجهة؟

قائمة الأزواج مفتوحة لكل حساب وتضم الأزواج التي تسعّرها Narwhal. يُدرج الزوج ما دام يُتداول مرة كل 30 ثانية على الأقل، ويُحذف عندما ينخفض عن مرة كل دقيقتين. تغطي الشموع اليومية وشموع الدقيقة الواحدة التاريخ الكامل. تقبل طلبات الأسعار الجماعية حتى 50 معرّفًا.

كيف تعمل أشرطة العملات المشفرة اليومية؟

تغطي كل شمعة يومية يوم UTC واحدًا وتظهر عند 00:00 UTC. لا تُعرض الشمعة الجزئية لليوم الحالي أبدًا.

ما مقدار سجل أسعار العملات المشفرة الذي يمكنني طلبه؟

يحصل كل حساب على الشموع اليومية وشموع الدقيقة الواحدة للتاريخ الكامل. وعندما لا تتوفر صفوف أقدم، يُرجع start أول تاريخ تم تقديمه.

ما الذي يمثله التغير خلال 24 ساعة؟

change_24h هو السعر ناقص السعر قبل 24 ساعة، ويُحسب من نسبة التغيّر خلال 24 ساعة. يعني الرقم 1.5 في حقل النسبة 1.5%. يُحذف حقلا التغيّر كلاهما كلما كان التغيّر غير معروف.

كيف تعمل معرّفات الأزواج والاستدعاءات الدفعية؟

يربط معرّف الزوج بين العملة المشفرة وعملة التسعير بشرطة، مثل BTC-USD. تعمل أي حالة أحرف، ويُقبل أيضًا الخط المائل. تقبل الاستدعاءات الدفعية ما يصل إلى 50 معرّفًا وتحتسب استدعاءً واحدًا لكل معرّف يعيد سعرًا.