جميع واجهات API

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

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

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

الطلب الأول

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

curl --request GET \
  --url "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/price" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "id": "XNAS:MSFT",
  "symbol": "MSFT",
  "currency": "USD",
  "price": "421.35",
  "previous_close": "418.90",
  "change": "2.45",
  "change_percent": "0.58",
  "volume": "18234100",
  "market_session": "open",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false
}

نقاط النهاية

GETالبحث عن الأسهم برمز التداول أو الاسم/v1/equities/search

الإدراجات التي يبدأ رمزها أو اسمها بالحرف q بأي حالة: الرمز المطابق تماماً أولاً، ثم الرموز الأخرى، ثم الأسماء.

المعلمات

  • qمطلوب

    بداية رمز أو اسم شركة، بأي حالة، وبحد أدنى حرفان (مثل ms أو micro). الترتيب: الرمز المطابق تماماً، ثم الرموز الأخرى، ثم بداية الاسم، ثم بداية كلمة لاحقة من الاسم؛ وتأتي الإدراجات الأمريكية الرئيسية أولاً ضمن كل مجموعة.

  • countryاختياري

    الرموز المُدرجة في هذه الدولة فقط، بثلاثة أحرف (USA, KOR).

  • typeاختياري

    هذا النوع من الرموز المُدرجة فقط.

  • cursorاختياري

    قيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.

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

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

    50 نتيجة في الصفحة كحد أقصى.

  • next_cursorسلسلة نصية

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

المرجع الكامل ‏←
GETالملف التعريفي لسهم واحد/v1/equities/{id}

الإدراج (الرمز والاسم والنوع والبورصة والدولة والعملة)، وقطاع الشركة وصناعتها وموقعها الإلكتروني، وcompany_id عندما يطابق الإدراج شركة في إفصاحاتنا.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • symbolسلسلة نصية

    رمز التداول في تلك البورصة.

  • micسلسلة نصية

    رمز البورصة المكوّن من أربعة أحرف.

  • countryسلسلة نصية

    دولة الرمز المُدرج، بثلاثة أحرف.

  • sectorسلسلة نصية

    القطاع. يُحذف للرموز المُدرجة في اليابان، فلا نص تعريفيًا لها.

  • industryسلسلة نصية

    النشاط الصناعي. يُحذف للرموز المُدرجة في اليابان.

  • websiteسلسلة نصية

    الموقع الإلكتروني للشركة. يُحذف للرموز المُدرجة في اليابان.

  • logo_urlسلسلة نصية

    نسختنا الخاصة من شعار الشركة. تُحذف عند عدم توفرها لدينا.

  • company_idسلسلة نصية

    معرّف الشركة في الإيداعات، عندما يطابق الرمز المُدرج شركة مطابقة واضحة.

المرجع الكامل ‏←
GETآخر سعر لسهم واحد/v1/equities/{id}/price

أحدث سعر لإدراج واحد.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

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

  • 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 بثوانٍ كاملة.

المرجع الكامل ‏←
GETآخر أسعار لما يصل إلى 50 سهمًا/v1/equities/prices

أحدث سعر لكل معرّف مُدرج.

المعلمات

  • idsمطلوب

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

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

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

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

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

    المعرّفات التي لم تعد سعرًا. لا تُحتسب عليها رسوم.

المرجع الكامل ‏←
GETأكثر الأسهم الأمريكية حركة/v1/equities/movers

أفضل 25 سهماً وصندوقاً متداولاً ETF أمريكياً حسب الاتجاه: الأكثر ارتفاعاً أو الأكثر انخفاضاً أو الأنشط (الأكثر تداولاً بالقيمة بين أكبر الرابحين والخاسرين في اليوم، وليس السوق كله).

المعلمات

  • marketاختياري

    السوق المراد ترتيبه. us فقط حالياً؛ أي سوق آخر يُرجع 404 not_covered.

  • directionاختياري

    gainers (أكبر ارتفاع) أو losers (أكبر انخفاض) أو active (الأكثر تداولاً بالقيمة بين أكبر الرابحين والخاسرين في اليوم، وليس السوق كله). أي قيمة أخرى تُرجع 400 invalid_query.

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

  • marketدائمًا "us"

    السوق الذي جرى ترتيبه.

  • directionإحدى القيم: gainers, losers, active

    الترتيب المطلوب.

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

    حتى 25 عنصرًا، الأفضل أولًا. الأسهم العادية وصناديق ETF فقط التي يبلغ سعرها $1 أو أكثر، وتداول منها اليوم 100,000 سهم على الأقل بقيمة $1 مليون على الأقل.

  • timestampتاريخ ووقت

    وقت صلاحية أحدث سعر في القائمة (UTC).

المرجع الكامل ‏←
GETشموع أسعار سهم واحد/v1/equities/{id}/bars

أشرطة يومية (1d) أو بدقيقة واحدة (1m)، من الأقدم إلى الأحدث، معدّلة لتجزئة الأسهم وتوزيعات الأرباح.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

  • intervalاختياري

    1d (one bar لكل session) 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 من الصفحة السابقة، مع المعاملات الأخرى نفسها. يتوقف المؤشر عن العمل عندما تتغير الأسعار التي يقوم عليها (تجزئة أسهم أو توزيع أرباح): 409 cursor_expired.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • currencyسلسلة نصية

    عملة كل سعر. يتحول البنس إلى جنيه.

  • adjustedمنطقي

    دائمًا true: الأسعار معدّلة لتجزئات الأسهم والتوزيعات. تتفق الصفحة والتي تليها دائمًا؛ وإذا غيّرت تجزئة أو توزيعة السجل بين صفحتين، يتوقف المؤشر عن العمل (409 cursor_expired) بدلًا من خلط الاثنتين.

  • startسلسلة نصية

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

  • endسلسلة نصية

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

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

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

  • next_cursorسلسلة نصية

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

المرجع الكامل ‏←
GETتوزيعات أرباح سهم واحد/v1/equities/{id}/dividends

توزيعات الأرباح النقدية لإدراج واحد، من الأحدث تاريخ استحقاق (ex-date)، مع ترقيم الصفحات.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

  • cursorاختياري

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • startالتاريخ

    لا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.

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

    الأحدث بحسب تاريخ الاستحقاق أولًا. قد تتضمن صفوفًا مستقبلية معلنة.

  • next_cursorسلسلة نصية

    مرّره كقيمة cursor للصفحة التالية؛ وهو null في الصفحة الأخيرة.

المرجع الكامل ‏←
GETتجزئات أسهم سهم واحد/v1/equities/{id}/splits

تجزئات الأسهم لإدراج واحد، من الأحدث.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • startالتاريخ

    لا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.

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

    الأحدث أولًا.

المرجع الكامل ‏←
GETأرباح سهم واحد/v1/equities/{id}/earnings

تقارير الأرباح السابقة لإدراج واحد (المؤرخة اليوم أو قبله بتوقيت البورصة)، مع التقدير والفعلي والمفاجأة، من الأحدث، مع ترقيم الصفحات.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

  • cursorاختياري

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • startالتاريخ

    لا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.

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

    التقارير السابقة فقط، الأحدث أولًا. مواعيد التقارير القادمة غير متاحة بعد.

  • next_cursorسلسلة نصية

    مرّره كقيمة cursor للصفحة التالية؛ وهو null في الصفحة الأخيرة.

المرجع الكامل ‏←
GETالقيمة السوقية وP/E وP/S وP/B وعائد التوزيعات لسهم واحد/v1/equities/{id}/valuation

القيمة السوقية (أحدث سعر مضروباً في الأسهم القائمة)، ومضاعف الربحية P/E (أحدث سعر على ربحية السهم المخففة لآخر 12 شهراً من إفصاحات الشركة، بمعايير GAAP أو IFRS كما أُفصح عنها)، ومضاعف المبيعات P/S (القيمة السوقية على إيرادات آخر 12 شهراً)، ومضاعف القيمة الدفترية P/B (القيمة السوقية على إجمالي حقوق الملكية في أحدث ميزانية عمومية)، وعائد توزيعات الأرباح (توزيعات السهم لآخر 12 شهراً على السعر، بالنسبة المئوية) لإدراج أمريكي أو كوري واحد، مع المدخلات والتواريخ التي تعود إليها.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • currencyسلسلة نصية

    عملة market_cap وعملة السعر الذي يقوم عليه pe_ratio.

  • market_capسلسلة نصية

    أحدث سعر مضروباً في shares_outstanding، بعملة currency، بوحدات كاملة. يُحذف عند حدوث تجزئة أسهم بعد shares_as_of، وعندما يكون للشركة عدة فئات أسهم دون عدد لكل منها، وفي حالة الإيصال الإيداعي أو المُفصح الأجنبي. لا توجد قيمة سوقية لكوريا بعد: تظهر لإدراجاتها نسبة P/E فقط حالياً.

  • pe_ratioسلسلة نصية

    أحدث سعر مقسوماً على eps_ttm، بمنزلتين عشريتين. يُحذف عندما يكون eps_ttm سالباً أو أقل من 0.01، وعندما لا تكون عملة التقرير هي currency، وعند حدوث تجزئة أسهم بعد eps_period_end، وفي حالة الإيصال الإيداعي.

  • ps_ratioسلسلة نصية

    السعر إلى المبيعات: market_cap مقسوماً على revenue_ttm، بمنزلتين عشريتين. يُحذف كلما حُذف market_cap، وعندما لا تكون الإيرادات أكبر من 0، وعندما تُفصح بعملة غير currency.

  • pb_ratioسلسلة نصية

    السعر إلى القيمة الدفترية: market_cap مقسوماً على total_equity، بمنزلتين عشريتين. يُحذف كلما حُذف market_cap، وعندما يكون إجمالي حقوق الملكية 0 أو سالباً، وعندما يُفصح عنه بعملة غير currency.

  • dividend_yieldسلسلة نصية

    توزيعات السهم لآخر 12 شهراً على أحدث سعر، بالنسبة المئوية (0.71 تعني 0.71%)، بمنزلتين عشريتين. يُحذف عندما لا يوجد توزيع مسجل لتلك الأشهر الـ12 (بما في ذلك الشركة التي لا توزع أرباحاً)، وعند حدوث تجزئة أسهم بعد dividends_period_end، وعندما تكون التوزيعات بعملة غير currency، وفي حالة الإيصال الإيداعي.

  • shares_outstandingسلسلة نصية

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

  • shares_as_ofالتاريخ

    التاريخ الذي يُحتسب عنده shares_outstanding. يظهر كلما ظهر العدد.

  • eps_ttmسلسلة نصية

    ربحية السهم المخففة لآخر 12 شهراً من إفصاحات الشركة (بمعايير GAAP أو IFRS كما أُفصح عنها)؛ والربع الرابع هو الرقم السنوي ناقص الأرباع الثلاثة الأولى. تظهر كلما أمكن حسابها؛ وتُحذف لإدراج هو فئة أخرى من الشركة. وقد تختلف عن eps_actual في أرباح الأسهم، وهي على أساس بيانات السوق.

المرجع الكامل ‏←
GETبيتا وتكلفة حقوق الملكية وتكلفة الدين وWACC لسهم واحد/v1/equities/{id}/cost-of-capital

بيتا لسهم أمريكي أو كوري واحد مقابل صندوق متداول ETF مرجعي (عوائد أسبوعية على مدى سنتين افتراضياً، من أسعار معدّلة لتجزئة الأسهم وتوزيعات الأرباح)، والمعدل الخالي من المخاطر (نقطة العشر سنوات من منحنى العائد الحكومي للدولة، أو معدلك أنت)، وتكلفة حقوق الملكية (المعدل الخالي من المخاطر زائد بيتا مضروباً في علاوة مخاطر الأسهم: علاوتك في erp، أو افتراضياً علاوتنا الكلية المنشورة لدولة السهم)، وتكلفة الدين (مصروف الفائدة على متوسط إجمالي الدين من إفصاحات الشركة، أو عند تعذر ذلك، المعدل الخالي من المخاطر زائد فارق التعثر الافتراضي من جدول عام لتغطية الفوائد في الشركة؛ قبل الضريبة وبعدها، بمعدل ضريبة الشركات للدولة من جدول عام ما لم ترسل tax_rate) والتكلفة المرجحة لرأس المال WACC، مرجحة بالقيمة السوقية وإجمالي الدين.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

  • erpاختياري

    علاوة مخاطر الأسهم الخاصة بك، بالنسبة المئوية (5 تعني 5%). عند حذفها تُستخدم علاوتنا الإجمالية المنشورة لمخاطر الأسهم في دولة السهم (تذكر الاستجابة تاريخها وأساسها). وحيث لا ننشر علاوة، تكون الاستجابة دونها 400 erp_required. أكبر من 0 وحتى 25 كحد أقصى.

  • benchmarkاختياري

    معرّف الرمز المُدرج للمرجع السوقي الذي تُقاس بيتا مقابله: صندوق ETF أو صندوق أو سهم مسعّر بعملة السهم نفسها. عند حذفه يكون ARCX:SPY للسهم الأمريكي، وXKRX:069500 للسهم الكوري، وXTKS:1306 للسهم الياباني؛ وأي سوق آخر يتطلبه.

  • windowاختياري

    المدى الذي تمتد إليه العوائد: 2y (الافتراضي) أو 5y.

  • frequencyاختياري

    فاصل العائد: weekly (الافتراضي؛ آخر يوم تداول مشترك في كل أسبوع ISO) أو monthly.

  • betaاختياري

    أي بيتا يغذّي تكلفة حقوق الملكية: raw (الافتراضي) أو adjusted (0.67 من raw زائد 0.33). كلتاهما موجودتان دائماً في الاستجابة.

  • risk_freeاختياري

    العائد الخالي من المخاطر الخاص بك، بالنسبة المئوية. عند حذفه يكون نقطة العشر سنوات من منحنى عائد السندات الحكومية للدولة. مطلوب حيث لا يتوفر لدينا منحنى (كوريا): ودونه تكون الاستجابة 422 risk_free_unavailable.

  • tax_rateاختياري

    معدل الضريبة الخاص بك للوفر الضريبي على الدين، بالنسبة المئوية. عند حذفه يكون معدل ضريبة الشركات في دولة السهم من جدول Damodaran العام (معدلات PwC). بين 0 و60.

  • periodاختياري

    فترة مصروف الفائدة: آخر 12 شهراً (ttm، الافتراضي) أو آخر سنة مالية كاملة (annual). كوريا واليابان لديهما أرقام سنوية فقط، لذلك تحصلان على annual.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • currencyسلسلة نصية

    عملة الحقول المالية.

  • company_idسلسلة نصية

    الشركة في إيداعاتنا التي يطابقها الرمز المُدرج.

  • cost_of_equityسلسلة نصية

    العائد الخالي من المخاطر مضافًا إليه بيتا مضروبة في علاوة مخاطر الأسهم، بالنسبة المئوية (4.25 تعني 4.25%).

  • cost_of_debtكائن

    يُحذف للشركة التي لا دين مسجلًا لها.

  • tax_rateكائن

    يُحذف عندما لا يكون للدولة معدل في الجدول. أرسل tax_rate لتحديد معدل.

  • waccسلسلة نصية

    التكلفة المرجحة لرأس المال، بالنسبة المئوية (4.25 تعني 4.25%). تساوي cost_of_equity لشركة بلا دين. تُحذف ما دام الدين موجوداً ولا يُعرف معدل ضريبة.

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

    أمور يجب التحقق منها قبل استخدام الأرقام. فارغة عند عدم وجودها.

  • methodology_urlسلسلة نصية

    كيف يُحسب كل رقم.

المرجع الكامل ‏←
GETسجل التقييم لسهم واحد/v1/equities/{id}/valuation/history

القيمة السوقية وP/E وP/S وP/B وعائد توزيعات الأرباح عند نهاية كل فترة مالية (نهاية ربع أو سنة) لإدراج أمريكي أو كوري واحد، من الأقدم إلى الأحدث.

المعلمات

  • idمطلوب

    معرّف الرمز المُدرج: رمز البورصة من أربعة أحرف، ثم نقطتان رأسيتان، ثم رمز التداول، مثل XNAS:MSFT أو XNYS:BRK.B. ويصلح أيضًا رمز أمريكي مجرد مثل MSFT إذا كان يشير إلى رمز مُدرج أمريكي واحد، وتتضمن الاستجابة المعرّف المعتمد. تستخدم فئات الأسهم نقطة (BRK.B)، ويُقبل أيضًا BRK-B.

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

  • idسلسلة نصية

    معرّف الرمز المُدرج المعتمد.

  • currencyسلسلة نصية

    عملة كل سعر وكل قيمة سوقية.

  • company_idسلسلة نصية

    الشركة في إيداعاتنا التي يطابقها الرمز المُدرج.

  • startالتاريخ

    لا يُرسل أبدًا: يحصل كل حساب على السجل الكامل.

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

    نقطة واحدة لكل نهاية فترة مالية للشركة، الأقدم أولًا. تُحسب كل نقطة من الأرقام المودعة لتلك الفترة ومن السعر في ذلك اليوم، وليس مما كان معروفًا حينها: فتدخل فيها أي إعادة بيان لاحقة. الفترة التي لا سعر لها، أو لا رقم فيها، لا نقطة لها.

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

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

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

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

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

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

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

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

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

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

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

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

ربط الأسهم بإفصاحات الشركات

استخدم company_id الخاص بالإدراج لربط أسعاره وتقييماته بالقوائم المالية للشركة.

استكشف API ‏←

API الصناديق المتداولة وصافي قيمة الأصول

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

استكشف API ‏←

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

أسعار أزواج العملات المشفرة وتاريخها عبر REST وMCP

استكشف API ‏←

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

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

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

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

كيف أكتب معرّف سهم؟

يجمع معرّف الإدراج رمز البورصة المكوّن من أربعة أحرف والرمز المختصر للسهم، مثل XNAS:MSFT لشركة Microsoft. تعمل الرموز الأمريكية المجردة الفريدة، وتعيد الإجابات المعرّف المعتمد.

كم التكلفة؟

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

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

أسعار الأسهم وصناديق ETF والعملات المشفرة مباشرة في كل حساب. تقبل الطلبات الجماعية حتى 50 معرّفًا وتحتسب كل سعر مُعاد.

ما بيانات التقييم المشمولة؟

الأسهم الأكثر حركة في الولايات المتحدة فقط، وتاريخ التقييم، وتكلفة رأس المال مع بيتا، كلها متاحة لكل حساب. يطابق التقييم الإدراجات الأمريكية والكورية بالإيداعات؛ وفي كوريا نسبة السعر إلى الأرباح فقط.

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

البحث والملفات التعريفية متاحان لكل حساب. تغطي الشموع اليومية والأرباح السابقة التاريخ الكامل، وتتبع التوزيعات وتجزئة الأسهم النطاق نفسه. شموع الدقيقة الواحدة مشمولة. يُحذف حجم اليوم عند عدم معرفته. القيمة السوقية ونسب P/E وP/S وP/B وعائد الأرباح الموزعة مشمولة. الأسعار والمبالغ سلاسل عشرية.

هل يتضمن API الأسهم أرباحًا قادمة أو أسعار اليابان؟

يعيد مسار الأرباح النتائج السابقة فقط؛ أما مواعيد الأرباح القادمة فغير متاحة. أسعار اليابان غير متاحة؛ وتحمل الملفات التعريفية الاسم والبورصة والدولة والعملة وcompany_id فقط. يستخدم eps_actual في الأرباح أساس بيانات السوق، بينما يأتي EPS الذي يقوم عليه pe_ratio من إفصاحات الشركات. قد يختلف الاثنان ولا ينبغي مقارنتهما مباشرة.

كيف يعمل سجل التقييم؟

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

ما الذي تتطلبه تكلفة رأس المال؟

تغطي تكلفة رأس المال إدراجات الولايات المتحدة وكوريا المطابقة لشركة في إفصاحاتنا، وتربط كل إجابة بمنهجية تكلفة رأس المال. أرسل علاوة مخاطر الأسهم لديك في erp. تعيد البنوك وشركات التأمين الخطأ 422 not_applicable لأن الفائدة تكلفة تشغيلية. أما المُدخل الذي لا يمكن حسابه فيُسمّى في 422 inputs_unavailable بدلًا من تقديره.

كيف ترتبط الأسعار بإفصاحات الشركات؟

يمكن أن يحمل الإدراج company_id الذي يربطه بشركة في API الإفصاحات. استخدم هذا المعرّف لربط الأسعار والتقييمات بالقوائم المالية. النسب التي لا يمكن حسابها بشكل صحيح تُحذف دون إرسال 0 بدلًا منها.