تصفّح التوثيق كاملًا

مرجع API لأداة فرز الشركات

اعثر على الشركات بعوامل تصفية على أحدث بياناتها الأساسية، واقرأ البنود المالية لما يصل إلى 10 شركات

نظرة عامة

تبحث أداة الفرز عن الشركات المدرجة التي تستوفي أحدث أرقامها المالية الشروط التي تحددها، عبر سجلات الإفصاحات التي يحتفظ بها Narwhal. ترسل عوامل تصفية مثل هامش صافي ربح أعلى من 20 في المئة، فتُرجع الشركات المطابقة بالأرقام التي طلبتها. يحتاج كل طلب إلى مفتاح Bearer، وتسحب REST وMCP من رصيد واحد.

ثلاثة مسارات. الأول يفرز. والثاني يسرد كل حقل وعامل مقارنة وعملة وسجل يمكن استخدامه في الفرز، ولا يكلّف شيئًا. والثالث يُرجع بنودًا مالية مختارة لما يصل إلى 10 شركات تعرفها مسبقًا، في طلب واحد. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193.

لكل شركة صف واحد لكل أساس: أحدث سنة مالية لها (annual)، أو أحدث ربع (quarterly)، أو آخر أربعة أرباع مجمعة (ttm). تُعاد بناء الصفوف كل ليلة من الإفصاحات، ويذكر built_at في قائمة عوامل التصفية موعد ذلك. المبالغ بعملة الشركة نفسها ولا تُحوَّل، لذا يحتاج عامل التصفية أو الترتيب على مبلغ إلى currency. ولكل مبلغ أيضًا نظير باللاحقة _usd، مثل revenue_usd، ولا يحتاج إلى عملة. حاليًا لا تُملأ أرقام _usd إلا للشركات التي تبلّغ بالدولار الأمريكي، لذا لا يُرجع عامل تصفية _usd غير هذه الشركات.

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

عنوان URL الأساسي: https://api.narwhalapi.com. كل مسار أدناه أداة MCP قائمة بذاتها، بالمعاملات نفسها.

القوائم المالية لشركة واحدة في مرجع filings API للقوائم المالية والإفصاحات.

معرّفات الشركات هي التي واجهة الإفصاحات (Filings API) يُرجعها بحث الشركات.

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

ماكل حساب
الفرزمشمول. استدعاء واحد لكل 10 شركات مُرجَعة، مع التقريب للأعلى
قائمة عوامل التصفيةمشمول. مجاني
البنود الماليةمشمول. استدعاء واحد لكل شركة موجودة، بحد أقصى 10

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

  • يُحاسَب الفرز بعدد الشركات في الصفحة التي يُرجعها، بسعر Companies وهو $10 لكل 1,000 استدعاء، أي $0.01 للاستدعاء: استدعاء واحد لكل 10 شركات، مع التقريب للأعلى. من 1 إلى 10 شركات استدعاء واحد ($0.01)، ومن 11 إلى 20 استدعاءان ($0.02)، والصفحة الكاملة من 100 شركة 10 استدعاءات ($0.10). الفرز الذي لا يطابق شيئًا مجاني، وكذلك كل خطأ.
  • تُحاسَب كل صفحة بصفوفها هي، لذا لا يغيّر تقسيم النتائج إلى صفحات السعر لكل شركة. صفحات من 10 وصفحة واحدة من 100 تكلّف المبلغ نفسه للشركات نفسها. والصفحة التي ليست من مضاعفات 10 تُقرَّب للأعلى، لذا limit 1 يكلّف $0.01 للشركة. وقراءة نتيجة كاملة بالمؤشرات تكلّف دائمًا استدعاءً واحدًا على الأقل لكل 10 شركات.
  • تكلفة الطلب موجودة في ترويسة الاستجابة X-Narwhal-Cost، بالدولار وبست خانات عشرية (صفحة من 23 شركة تُظهر 0.030000)، وX-Narwhal-Balance هو المتبقي. والإجابة نفسها لا تحتوي حقل تكلفة. وعبر MCP يُخصم المبلغ نفسه من الرصيد ويظهر في سجل الاستدعاءات. الفرز الذي لا يطابق شيئًا يُظهر 0.000000.
  • يُرفض الطلب بالخطأ 402 insufficient_credits قبل تنفيذه إذا كان الرصيد أقل من استدعاء واحد، وبعد تنفيذه إذا كان الرصيد لا يكفي لدفع تكلفة الصفحة كاملة. وفي الحالتين لا تُسلَّم الشركات ولا يُخصم شيء. أرسل limit أصغر لتدفع أقل.
  • يقبل الفرز حتى 20 عامل تصفية. ويقبل عامل المقارنة in من 1 إلى 50 قيمة. عوامل المقارنة التي يقبلها كل حقل مذكورة في قائمة عوامل التصفية، وعامل التصفية الذي لا يناسب حقله يعطي 400 invalid_query مع السبب. وتُطابَق القيم النصية دون اعتبار لحالة الأحرف.
  • قيمة limit هي 25 ما لم تحددها، وبحد أقصى 100. وبدون order_by تأتي الشركات بترتيب معرّف الشركة. ويقبل order_by حقلًا رقميًا، وقيمة order هي desc ما لم تضبطها على asc.
  • قد تنتهي الصفحة بـ next_cursor. أعد إرساله بوصفه cursor مع المعاملات الأخرى نفسها. ومؤشر المتابعة من استعلام آخر يُرجع 400 invalid_cursor.
  • يسمّي fields ما يصل إلى 106 حقول رقمية لإرجاعها. وبدونه يحمل الصف الحقول التي صفّيتَ بها أو رتّبتَ عليها، أو الإيرادات وصافي الدخل وإجمالي الأصول إن لم يكن هناك شيء منها. الأرقام سلاسل عشرية، ويُحذف الحقل الذي لا قيمة له للشركة.
  • إذا أعاد إفصاح لاحق صياغة رقم ما، تعرض أداة الفرز القيمة المعاد صياغتها، كما في مسار القوائم المالية.
  • يفرز as_of الشركات كما كانت في يوم ماضٍ، ابتداءً من 31 يناير 2010. تُحفظ الصفوف لنهايات الأشهر، لذا يظهر الإفصاح من نهاية الشهر التي تلي تقديمه. لا تُغطّى إلا الشركات المدرجة اليوم، وتُستبعد الشركة التي تنتهي أحدث أرقامها قبل ذلك اليوم بأكثر من 18 شهرًا. ولا يمكن استخدام حقول السعر مع as_of، واليوم في المستقبل يعطي 400 invalid_query.
  • تقبل البنود المالية حتى 10 قيم في tickers وحتى 20 في line_items، وlimit حده الأقصى 40 فترة لكل شركة. ورمز التداول الذي لا يطابق أي شركة يُدرج في not_found ولا يكلّف شيئًا، والشركة المذكورة مرتين (AAPL وusa:AAPL) تُوجَد وتُحاسَب مرة واحدة. وتعمل قيود الخطة والأرقام المحجوبة (الأرقام التي لم تجتز فحص المعقولية ولا تظهر في أي إجابة) والإفصاحات المسحوبة كما في مسار القوائم المالية.

نقاط النهاية

Each route is marked GET or POST. A POST route takes a JSON body, and its parameters below are the fields of that body. Every route needs your key in the Authorization: Bearer الترويسة. تعرض الأمثلة شكل الاستجابة، وليست بيانات مباشرة.

فرز الشركات بحسب بياناتها الأساسية

POST /v1/companies/screen

اعثر على الشركات المدرجة بحسب أحدث سنة مالية لها عبر سجلات الإفصاحات: قائمة filters على الحقول الواردة في قائمة عوامل التصفية، وترتيب اختياري، والحقول المطلوب إرجاعها. تُقسَّم إلى صفحات بـ next_cursor. ويعتمد السعر على الشركات المُرجَعة: استدعاء واحد لكل 10، مع التقريب للأعلى.

كل عامل تصفية كائن فيه field وoperator (gt أو gte أو lt أو lte أو eq أو ne أو in) وvalue. والقيمة value رقم أو نص، وقائمة مع in، والتاريخ بصيغة YYYY-MM-DD.

السعر استدعاء واحد لكل 10 شركات في الصفحة، مع التقريب للأعلى، ولا شيء للصفحة الفارغة. انظر الحدود أعلاه.

MCP: الأداة filings_screen_companies.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
basisbodyلاone of annual, quarterly, ttmأي صف من كل شركة يُفرز: annual: أحدث سنة مالية. تغطي التدفقات السنة، والأرصدة عند نهايتها. quarterly: أحدث ربع. تغطي التدفقات ذلك الربع وحده (والربع الرابع الذي لا يُقدَّم منفردًا هو السنة ناقص الأرباع الثلاثة الأولى)، والأرصدة عند نهايته. ويُقاس النمو مقابل الربع نفسه قبل سنة. والشركة التي تقدّم إفصاحاتها سنويًا فقط ليس لها صف ربعي. ttm: آخر أربعة أرباع مجمعة (السنة المالية نفسها للشركة التي تقدّم إفصاحاتها سنويًا فقط أو التي لا تكون أرباعها أربعة متتالية)؛ والأرصدة عند نهاية الربع الأخير. ويُقاس النمو مقابل الأرباع الأربعة المنتهية قبل سنة. وتستخدم نسب الأسعار، حيث تُعرض، هذا الأساس أيًا كان الصف المطلوب.
filtersbodyلاقائمة كائناتالشروط التي يجب أن تستوفيها الشركة، وكل شرط بصيغة {field, operator, value}. بحد أقصى 20. وبدون عوامل تصفية تطابق كل الشركات.
currencybodyلاسلسلة نصيةالشركات التي تبلّغ بهذه العملة فقط. لا تُحوَّل المبالغ، لذا يحتاج عامل التصفية أو الترتيب على حقل مبلغ أو حقل لكل سهم إلى عملة واحدة هنا أو إلى عامل تصفية eq على currency.
fieldsbodyلاlist of stringالحقول الرقمية المطلوب إرجاعها. الافتراضي: الحقول التي صُفّي أو رُتّب عليها.
order_bybodyلاسلسلة نصيةحقل رقمي. الافتراضي: معرّف الشركة.
orderbodyلاone of asc, descdesc يضع أعلى قيمة لـ order_by أولًا، وasc أدناها. الافتراضي desc.
langbodyلاone of en, originalen يرسل الاسم الإنجليزي للشركة حيث يكون معروفًا، وoriginal الاسم كما قُدّم. الافتراضي en.
as_ofbodyلاالتاريخافرز الشركات كما كانت في هذا اليوم: أحدث صف لكل شركة مبني من الإفصاحات المقدمة حتى ذلك الحين، ابتداءً من 2010-01-31. تُحفظ الصفوف لنهايات الأشهر، لذا يظهر الإفصاح من نهاية الشهر التي تلي تقديمه (وليس قبل ذلك أبدًا). لا تُغطّى إلا الشركات المدرجة اليوم، وتُستبعد الشركة التي تنتهي أحدث أرقامها قبل ذلك اليوم بأكثر من 18 شهرًا. حقول السعر (close وmarket_cap ونسب الأسعار والعوائد) غير محفوظة ولا يمكن استخدامها معه.
limitbodyلاعدد صحيحعدد الشركات في الصفحة، من 1 إلى 100. الافتراضي 25. تُحاسَب الصفحة باستدعاء واحد لكل 10 شركات، مع التقريب للأعلى.
cursorbodyلاسلسلة نصيةقيمة next_cursor من الصفحة السابقة، مع المعاملات الأخرى نفسها.

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

حقلالنوعيُرسلالمعنى
companiesقائمة كائناتدائمًاالشركات في هذه الصفحة، صف لكل شركة. القائمة الفارغة تعني أن شيئًا لم يطابق.
companies[].idسلسلة نصيةدائمًامعرّف الشركة، لمسارات Filings API الأخرى.
companies[].nameسلسلة نصيةدائمًااسم الشركة، بالإنجليزية حيث تكون lang هي en ويكون الاسم معروفًا.
companies[].tickerسلسلة نصيةاختياريرمز التداول الذي تُتداول به الشركة، إن وُجد.
companies[].registryone of usa, jpn, kor, gbr, twn, aut, bel, cyp, cze, dnk, est, esp, fin, fra, grc, hrv, hun, isl, ita, ltu, lux, lva, mlt, nld, nor, pol, prt, rou, swe, svn, svkدائمًاالسجل الذي تقدّم الشركة إفصاحاتها إليه.
companies[].countryسلسلة نصيةاختياريبلد الشركة، رمز ISO 3166-1 alpha-3.
companies[].isicسلسلة نصيةاختياريرمز ISIC لقطاع الشركة.
companies[].currencyسلسلة نصيةاختياريالعملة التي تبلّغ بها الشركة.
companies[].fiscal_yearعدد صحيحاختياريالسنة المالية للصف.
companies[].period_endالتاريخاختياريآخر يوم في فترة الصف.
companies[].filed_onالتاريخاختيارياليوم الذي قُدّم فيه الإفصاح الذي جاء منه الصف.
next_cursorسلسلة نصيةاختياريأعد إرساله بوصفه cursor لقراءة الصفحة التالية. يُحذف في الصفحة الأخيرة.
طلب
curl -X POST -H "Authorization: Bearer $NARWHAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":[{"field":"net_margin","operator":"gt","value":20},{"field":"revenue","operator":"gt","value":50000000000}],"currency":"USD","order_by":"net_margin","fields":["net_margin","revenue"],"limit":3}' \
  "https://api.narwhalapi.com/v1/companies/screen"
استجابة نموذجية
{
  "companies": [
    {
      "id": "usa:0000723125",
      "name": "MICRON TECHNOLOGY INC",
      "ticker": "MU",
      "registry": "usa",
      "country": "USA",
      "isic": "2610",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-09-03",
      "filed_on": "2026-10-09",
      "revenue": "133188000000",
      "net_margin": "63.7963"
    },
    {
      "id": "usa:0001045810",
      "name": "NVIDIA CORP",
      "ticker": "NVDA",
      "registry": "usa",
      "country": "USA",
      "isic": "2610",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-01-25",
      "filed_on": "2026-02-25",
      "revenue": "215938000000",
      "net_margin": "55.6025"
    },
    {
      "id": "usa:0000789019",
      "name": "MICROSOFT CORP",
      "ticker": "MSFT",
      "registry": "usa",
      "country": "USA",
      "isic": "5820",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-06-30",
      "filed_on": "2026-07-29",
      "revenue": "331839000000",
      "net_margin": "40.3054"
    }
  ],
  "next_cursor": "eyJpIjo3MjYsImtpbmQiOiJzY3JlZW4iLCJvIjoiNDAuMzA1NCIsInEiOiJlMWFjYzEzMjM1NTE5OGNmIiwidiI6MX0.z_-8qfS3wrPvM52pvfH2QEc6Z8LcktMIJH8zF5yjvmo"
}

سرد حقول أداة الفرز وحدودها

GET /v1/companies/screen/filters

كل حقل يمكن للفرز أن يصفّي به ويرتّب ويُرجعه، مع نوعه ووحدته وعوامل المقارنة الخاصة به، والأسس والعملات والسجلات التي تحتفظ بها أداة الفرز، وحدودها. مجاني: لا يُحاسَب هذا المسار.

الإجابة هي نفسها لكل الحسابات. أعداد العملات والسجلات هي أعداد أحدث إعادة بناء.

MCP: الأداة filings_get_screen_filters.

المعلمات

لا يأخذ هذا المسار أي معاملات.

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

حقلالنوعيُرسلالمعنى
fieldsقائمة كائناتدائمًا
fields[].fieldسلسلة نصيةدائمًااسم الحقل، كما يُستخدم في filters وorder_by وfields.
fields[].typeone of text, date, integer, amount, per_share, shares, percent, ratio, days, usdدائمًانوع القيمة التي يحملها الحقل.
fields[].operatorslist of one of gt, gte, lt, lte, eq, ne, inدائمًاعوامل المقارنة التي يقبلها عامل تصفية على هذا الحقل.
fields[].unitسلسلة نصيةاختياريوحدة القيمة، إن وُجدت.
fields[].descriptionسلسلة نصيةدائمًاما هو الحقل.
basesقائمة كائناتدائمًا
bases[].basisone of annual, quarterly, ttmدائمًاقيمة لـ basis.
bases[].descriptionسلسلة نصيةدائمًاأي صف من كل شركة يفرزه.
currenciesقائمة كائناتدائمًاالعملات التي تبلّغ بها الشركات، مع عدد الشركات لكل منها.
currencies[].valueسلسلة نصيةدائمًارمز عملة.
currencies[].companiesعدد صحيحدائمًاعدد الشركات التي تبلّغ بها.
registriesقائمة كائناتدائمًا
registries[].valueسلسلة نصيةدائمًارمز سجل.
registries[].companiesعدد صحيحدائمًاعدد الشركات التي يضمها.
built_atتاريخ ووقتاختياريوقت آخر إعادة بناء لجدول أداة الفرز.
max_filtersعدد صحيحاختياريأكثر عدد من عوامل التصفية يقبله الفرز.
max_limitعدد صحيحاختياريأكثر عدد من الشركات تضمه الصفحة.
طلب
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/screen/filters"
استجابة نموذجية
{ "fields": [ { "field": "registry", "type": "text", "operators": [ "eq", "ne", "in" ], "description": "Registry that holds the company (usa, jpn, kor, ...)." }, { "field": "revenue", "type": "amount", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "currency", "description": "Revenue in `currency`, for the period of the row (see `basis`)." }, { "field": "net_margin", "type": "percent", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "percent", "description": "Net income over revenue (revenue above zero)." }, { "field": "revenue_usd", "type": "usd", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "USD", "description": "revenue in US dollars: the figure times `usd_rate_avg` (the period's average rate). Empty where there is no rate. Today the `_usd` figures are filled only for companies that report in US dollars, so a `_usd` filter returns only those companies." } ], "bases": [ { "basis": "annual", "description": "The newest fiscal year. Flows cover the year; balances are at its end." }, { "basis": "quarterly", "description": "The newest quarter. Flows cover that quarter alone (a fourth quarter that is not filed on its own is the year minus the first three); balances are at its end. Growth is against the same quarter a year before. A company that files only annually has no quarterly row." }, { "basis": "ttm", "description": "The last four quarters added up (the fiscal year itself for a company that files only annually or whose quarters are not four in a row); balances are at the end of the last quarter. Growth is against the four quarters ending a year before. Price ratios, where offered, use this basis whatever row is asked for." } ], "currencies": [ { "value": "USD", "companies": 5408 }, { "value": "JPY", "companies": 3804 }, { "value": "KRW", "companies": 2628 } ], "registries": [ { "value": "usa", "companies": 5520 }, { "value": "jpn", "companies": 3784 }, { "value": "kor", "companies": 2637 } ], "built_at": "2026-11-16T04:18:58.438922Z", "max_filters": 20, "max_limit": 100 }

الحصول على بنود مالية مختارة لما يصل إلى 10 شركات

POST /v1/companies/line-items

بنود مالية مختارة لما يصل إلى 10 قيم في tickers في طلب واحد: فترات كل شركة، الأحدث أولًا. وتُدرج رموز التداول التي لا تطابق أي شركة في not_found. استدعاء واحد لكل شركة موجودة.

قيمة period هي annual ما لم تحددها. تحمل الإجابة صفوف الفترة التي طلبتها تحت هذا الاسم، الأحدث أولًا، وصفوف ttm تحت ttm.

السعر استدعاء واحد لكل شركة موجودة، بحد أقصى 10. والطلب الذي لا يجد شيئًا مجاني.

MCP: الأداة filings_search_line_items.

المعلمات

معلمةالموضعمطلوبالنوعالمعنى
tickersbodyنعمlist of stringمعرّفات الشركات (usa:0000320193)، أو رموز تداول مع السجل (usa:AAPL وjpn:7203)، أو رموز التداول الأمريكية المجردة (AAPL).
line_itemsbodyنعمlist of stringأسماء البنود الموحّدة، كما في fields في مسار القوائم المالية.
periodbodyلاone of annual, semiannual, quarterly, ttmttm هو آخر أربعة أرباع مجمعة عند نهاية كل ربع (بنود الميزانية العمومية هي بنود الربع الأخير؛ والشركة التي تقدّم إفصاحاتها سنويًا فقط تحصل على سنواتها المالية). والباقي كما في مسار القوائم المالية.
start_datebodyلاالتاريخالفترات المنتهية في هذا اليوم أو بعده فقط.
end_datebodyلاالتاريخالفترات المنتهية في هذا اليوم أو قبله فقط.
limitbodyلاعدد صحيحعدد الفترات لكل شركة، الأحدث أولًا. الافتراضي: 1، أو كل فترة في نطاق التواريخ (بحد أقصى 40) عند تحديد تاريخ.

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

حقلالنوعيُرسلالمعنى
resultsقائمة كائناتدائمًا
results[].idسلسلة نصيةدائمًامعرّف الشركة.
results[].currencyسلسلة نصيةاختياريعملة الأرقام.
results[].basisone of consolidated, standaloneاختياريهل الأرقام موحّدة أم منفردة.
results[].from_fyعدد صحيحاختياريأول سنة مالية تعود إليها الصفوف.
results[].annualقائمة كائناتاختياريالصفوف السنوية، الأحدث أولًا. تُرسل عندما تكون period هي annual.
results[].annual[].fyعدد صحيحدائمًاالسنة المالية للصف.
results[].annual[].fqعدد صحيحاختياريالربع المالي، لصف ربعي.
results[].annual[].fhعدد صحيحاختياريالنصف المالي، لصف نصف سنوي.
results[].annual[].endالتاريخدائمًاآخر يوم في الفترة.
results[].annual[].formسلسلة نصيةاختيارينموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_items مختلفة.
results[].annual[].currencyسلسلة نصيةاختياريعملة الأسعار.
results[].annual[].derivedlist of stringاختياريبنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح.
results[].semiannualقائمة كائناتاختياريصفوف نصف السنة، الأحدث أولًا. تُرسل عندما تكون period هي semiannual.
results[].semiannual[].fyعدد صحيحدائمًاالسنة المالية للصف.
results[].semiannual[].fqعدد صحيحاختياريالربع المالي، لصف ربعي.
results[].semiannual[].fhعدد صحيحاختياريالنصف المالي، لصف نصف سنوي.
results[].semiannual[].endالتاريخدائمًاآخر يوم في الفترة.
results[].semiannual[].formسلسلة نصيةاختيارينموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_items مختلفة.
results[].semiannual[].currencyسلسلة نصيةاختياريعملة الأسعار.
results[].semiannual[].derivedlist of stringاختياريبنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح.
results[].quarterlyقائمة كائناتاختياريالصفوف الربعية، الأحدث أولًا. تُرسل عندما تكون period هي quarterly.
results[].quarterly[].fyعدد صحيحدائمًاالسنة المالية للصف.
results[].quarterly[].fqعدد صحيحاختياريالربع المالي، لصف ربعي.
results[].quarterly[].fhعدد صحيحاختياريالنصف المالي، لصف نصف سنوي.
results[].quarterly[].endالتاريخدائمًاآخر يوم في الفترة.
results[].quarterly[].formسلسلة نصيةاختيارينموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_items مختلفة.
results[].quarterly[].currencyسلسلة نصيةاختياريعملة الأسعار.
results[].quarterly[].derivedlist of stringاختياريبنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح.
results[].as_ofالتاريخاختيارياليوم الذي تُعد الأرقام كما هي فيه، حيث تطلب الفترة ذلك.
results[].ttmقائمة كائناتاختياريصفوف آخر أربعة أرباع، الأحدث أولًا. تُرسل عندما تكون period هي ttm.
results[].ttm[].fyعدد صحيحدائمًاالسنة المالية للصف.
results[].ttm[].fqعدد صحيحاختياريالربع المالي، لصف ربعي.
results[].ttm[].fhعدد صحيحاختياريالنصف المالي، لصف نصف سنوي.
results[].ttm[].endالتاريخدائمًاآخر يوم في الفترة.
results[].ttm[].formسلسلة نصيةاختيارينموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_items مختلفة.
results[].ttm[].currencyسلسلة نصيةاختياريعملة الأسعار.
results[].ttm[].derivedlist of stringاختياريبنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح.
not_foundlist of stringاختياريرموز التداول أو المعرّفات التي لا تطابق أي شركة.
طلب
curl -X POST -H "Authorization: Bearer $NARWHAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tickers":["AAPL","MSFT"],"line_items":["revenue","net_income"],"limit":1}' \
  "https://api.narwhalapi.com/v1/companies/line-items"
استجابة نموذجية
{
  "results": [
    {
      "id": "usa:0000320193",
      "currency": "USD",
      "annual": [
        {
          "fy": 2026,
          "end": "2026-09-26",
          "form": "10-K",
          "derived": [],
          "revenue": "478834000000",
          "net_income": "132175000000"
        }
      ],
      "as_of": "2026-11-03"
    },
    {
      "id": "usa:0000789019",
      "currency": "USD",
      "annual": [
        {
          "fy": 2026,
          "end": "2026-06-30",
          "form": "10-K",
          "derived": [],
          "revenue": "331839000000",
          "net_income": "133749000000"
        }
      ],
      "as_of": "2026-07-29"
    }
  ],
  "not_found": []
}

الأخطاء

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

الرمزالحالةالمعنى
invalid_query400معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه.
invalid_cursor400مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف.
insufficient_credits402رصيدك أقل من تكلفة الطلب.
screener_unavailable503لم يُبنَ جدول أداة الفرز الليلي بعد. حاول مرة أخرى لاحقًا. لا يُحاسَب هذا.
company_data_unavailable503تعذرت قراءة فرز `as_of` في الوقت المناسب. حاول مرة أخرى بعد قليل. لا يُحاسَب هذا.

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