مرجع API لأداة فرز الشركات
اعثر على الشركات بعوامل تصفية على أحدث بياناتها الأساسية، واقرأ البنود المالية لما يصل إلى 10 شركات
نظرة عامة
تبحث أداة الفرز عن الشركات المدرجة التي تستوفي أحدث أرقامها المالية الشروط التي تحددها، عبر سجلات الإفصاحات التي يحتفظ بها Narwhal. ترسل عوامل تصفية مثل هامش صافي ربح أعلى من 20 في المئة، فتُرجع الشركات المطابقة بالأرقام التي طلبتها. يحتاج كل طلب إلى مفتاح Bearer، وتسحب REST وMCP من رصيد واحد.
ثلاثة مسارات. الأول يفرز. والثاني يسرد كل حقل وعامل مقارنة وعملة وسجل يمكن استخدامه في الفرز، ولا يكلّف شيئًا. والثالث يُرجع بنودًا مالية مختارة لما يصل إلى 10 شركات تعرفها مسبقًا، في طلب واحد. تُحدَّد الشركة بمعرّفها في Filings API، مثل usa:0000320193.
لكل شركة صف واحد لكل أساس: أحدث سنة مالية لها (annual)، أو أحدث ربع (quarterly)، أو آخر أربعة أرباع مجمعة (ttm). تُعاد بناء الصفوف كل ليلة من الإفصاحات، ويذكر built_ في قائمة عوامل التصفية موعد ذلك. المبالغ بعملة الشركة نفسها ولا تُحوَّل، لذا يحتاج عامل التصفية أو الترتيب على مبلغ إلى currency. ولكل مبلغ أيضًا نظير باللاحقة _، مثل revenue_، ولا يحتاج إلى عملة. حاليًا لا تُملأ أرقام _ إلا للشركات التي تبلّغ بالدولار الأمريكي، لذا لا يُرجع عامل تصفية _ غير هذه الشركات.
أداة الفرز مبنية على البيانات الأساسية. تُملأ حقول السعر من الإغلاق اليومي بعد تشغيل تلك المهمة للشركة، وتبقى فارغة قبل ذلك. الرقم الذي لم تبلّغ عنه الشركة يُحذف من صفها، والشركة التي لا قيمة لها في حقل ما لا تطابق أبدًا عامل تصفية عليه.
عنوان URL الأساسي: https:/. كل مسار أدناه أداة 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 تُقرَّب للأعلى، لذا
limit1 يكلّف $0.01 للشركة. وقراءة نتيجة كاملة بالمؤشرات تكلّف دائمًا استدعاءً واحدًا على الأقل لكل 10 شركات. - تكلفة الطلب موجودة في ترويسة الاستجابة
X-Narwhal-Cost، بالدولار وبست خانات عشرية (صفحة من 23 شركة تُظهر0.030000)، وX-Narwhal-Balanceهو المتبقي. والإجابة نفسها لا تحتوي حقل تكلفة. وعبر MCP يُخصم المبلغ نفسه من الرصيد ويظهر في سجل الاستدعاءات. الفرز الذي لا يطابق شيئًا يُظهر0.000000. - يُرفض الطلب بالخطأ 402
insufficient_قبل تنفيذه إذا كان الرصيد أقل من استدعاء واحد، وبعد تنفيذه إذا كان الرصيد لا يكفي لدفع تكلفة الصفحة كاملة. وفي الحالتين لا تُسلَّم الشركات ولا يُخصم شيء. أرسلcredits limitأصغر لتدفع أقل. - يقبل الفرز حتى 20 عامل تصفية. ويقبل عامل المقارنة
inمن 1 إلى 50 قيمة. عوامل المقارنة التي يقبلها كل حقل مذكورة في قائمة عوامل التصفية، وعامل التصفية الذي لا يناسب حقله يعطي 400invalid_مع السبب. وتُطابَق القيم النصية دون اعتبار لحالة الأحرف.query - قيمة
limitهي 25 ما لم تحددها، وبحد أقصى 100. وبدونorder_تأتي الشركات بترتيب معرّف الشركة. ويقبلby order_حقلًا رقميًا، وقيمةby orderهيdescما لم تضبطها علىasc. - قد تنتهي الصفحة بـ
next_. أعد إرساله بوصفهcursor cursorمع المعاملات الأخرى نفسها. ومؤشر المتابعة من استعلام آخر يُرجع 400invalid_.cursor - يسمّي
fieldsما يصل إلى 106 حقول رقمية لإرجاعها. وبدونه يحمل الصف الحقول التي صفّيتَ بها أو رتّبتَ عليها، أو الإيرادات وصافي الدخل وإجمالي الأصول إن لم يكن هناك شيء منها. الأرقام سلاسل عشرية، ويُحذف الحقل الذي لا قيمة له للشركة. - إذا أعاد إفصاح لاحق صياغة رقم ما، تعرض أداة الفرز القيمة المعاد صياغتها، كما في مسار القوائم المالية.
- يفرز
as_الشركات كما كانت في يوم ماضٍ، ابتداءً من 31 يناير 2010. تُحفظ الصفوف لنهايات الأشهر، لذا يظهر الإفصاح من نهاية الشهر التي تلي تقديمه. لا تُغطّى إلا الشركات المدرجة اليوم، وتُستبعد الشركة التي تنتهي أحدث أرقامها قبل ذلك اليوم بأكثر من 18 شهرًا. ولا يمكن استخدام حقول السعر معof as_، واليوم في المستقبل يعطي 400of 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_. ويعتمد السعر على الشركات المُرجَعة: استدعاء واحد لكل 10، مع التقريب للأعلى.
كل عامل تصفية كائن فيه field وoperator (gt أو gte أو lt أو lte أو eq أو ne أو in) وvalue. والقيمة value رقم أو نص، وقائمة مع in، والتاريخ بصيغة YYYY-MM-DD.
السعر استدعاء واحد لكل 10 شركات في الصفحة، مع التقريب للأعلى، ولا شيء للصفحة الفارغة. انظر الحدود أعلاه.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
basis | body | لا | one of annual, quarterly, ttm | أي صف من كل شركة يُفرز: annual: أحدث سنة مالية. تغطي التدفقات السنة، والأرصدة عند نهايتها. quarterly: أحدث ربع. تغطي التدفقات ذلك الربع وحده (والربع الرابع الذي لا يُقدَّم منفردًا هو السنة ناقص الأرباع الثلاثة الأولى)، والأرصدة عند نهايته. ويُقاس النمو مقابل الربع نفسه قبل سنة. والشركة التي تقدّم إفصاحاتها سنويًا فقط ليس لها صف ربعي. ttm: آخر أربعة أرباع مجمعة (السنة المالية نفسها للشركة التي تقدّم إفصاحاتها سنويًا فقط أو التي لا تكون أرباعها أربعة متتالية)؛ والأرصدة عند نهاية الربع الأخير. ويُقاس النمو مقابل الأرباع الأربعة المنتهية قبل سنة. وتستخدم نسب الأسعار، حيث تُعرض، هذا الأساس أيًا كان الصف المطلوب. |
filters | body | لا | قائمة كائنات | الشروط التي يجب أن تستوفيها الشركة، وكل شرط بصيغة {field, operator, value}. بحد أقصى 20. وبدون عوامل تصفية تطابق كل الشركات. |
currency | body | لا | سلسلة نصية | الشركات التي تبلّغ بهذه العملة فقط. لا تُحوَّل المبالغ، لذا يحتاج عامل التصفية أو الترتيب على حقل مبلغ أو حقل لكل سهم إلى عملة واحدة هنا أو إلى عامل تصفية eq على currency. |
fields | body | لا | list of string | الحقول الرقمية المطلوب إرجاعها. الافتراضي: الحقول التي صُفّي أو رُتّب عليها. |
order_ | body | لا | سلسلة نصية | حقل رقمي. الافتراضي: معرّف الشركة. |
order | body | لا | one of asc, desc | desc يضع أعلى قيمة لـ order_ أولًا، وasc أدناها. الافتراضي desc. |
lang | body | لا | one of en, original | en يرسل الاسم الإنجليزي للشركة حيث يكون معروفًا، وoriginal الاسم كما قُدّم. الافتراضي en. |
as_ | body | لا | التاريخ | افرز الشركات كما كانت في هذا اليوم: أحدث صف لكل شركة مبني من الإفصاحات المقدمة حتى ذلك الحين، ابتداءً من 2010-01-31. تُحفظ الصفوف لنهايات الأشهر، لذا يظهر الإفصاح من نهاية الشهر التي تلي تقديمه (وليس قبل ذلك أبدًا). لا تُغطّى إلا الشركات المدرجة اليوم، وتُستبعد الشركة التي تنتهي أحدث أرقامها قبل ذلك اليوم بأكثر من 18 شهرًا. حقول السعر (close وmarket_ ونسب الأسعار والعوائد) غير محفوظة ولا يمكن استخدامها معه. |
limit | body | لا | عدد صحيح | عدد الشركات في الصفحة، من 1 إلى 100. الافتراضي 25. تُحاسَب الصفحة باستدعاء واحد لكل 10 شركات، مع التقريب للأعلى. |
cursor | body | لا | سلسلة نصية | قيمة next_ من الصفحة السابقة، مع المعاملات الأخرى نفسها. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
companies | قائمة كائنات | دائمًا | الشركات في هذه الصفحة، صف لكل شركة. القائمة الفارغة تعني أن شيئًا لم يطابق. |
companies[].id | سلسلة نصية | دائمًا | معرّف الشركة، لمسارات Filings API الأخرى. |
companies[].name | سلسلة نصية | دائمًا | اسم الشركة، بالإنجليزية حيث تكون lang هي en ويكون الاسم معروفًا. |
companies[].ticker | سلسلة نصية | اختياري | رمز التداول الذي تُتداول به الشركة، إن وُجد. |
companies[].registry | one 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_ | عدد صحيح | اختياري | السنة المالية للصف. |
companies[].period_ | التاريخ | اختياري | آخر يوم في فترة الصف. |
companies[].filed_ | التاريخ | اختياري | اليوم الذي قُدّم فيه الإفصاح الذي جاء منه الصف. |
next_ | سلسلة نصية | اختياري | أعد إرساله بوصفه 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_.
المعلمات
لا يأخذ هذا المسار أي معاملات.
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
fields | قائمة كائنات | دائمًا | |
fields[].field | سلسلة نصية | دائمًا | اسم الحقل، كما يُستخدم في filters وorder_ وfields. |
fields[].type | one of text, date, integer, amount, per_share, shares, percent, ratio, days, usd | دائمًا | نوع القيمة التي يحملها الحقل. |
fields[].operators | list of one of gt, gte, lt, lte, eq, ne, in | دائمًا | عوامل المقارنة التي يقبلها عامل تصفية على هذا الحقل. |
fields[].unit | سلسلة نصية | اختياري | وحدة القيمة، إن وُجدت. |
fields[].description | سلسلة نصية | دائمًا | ما هو الحقل. |
bases | قائمة كائنات | دائمًا | |
bases[].basis | one of annual, quarterly, ttm | دائمًا | قيمة لـ basis. |
bases[].description | سلسلة نصية | دائمًا | أي صف من كل شركة يفرزه. |
currencies | قائمة كائنات | دائمًا | العملات التي تبلّغ بها الشركات، مع عدد الشركات لكل منها. |
currencies[].value | سلسلة نصية | دائمًا | رمز عملة. |
currencies[].companies | عدد صحيح | دائمًا | عدد الشركات التي تبلّغ بها. |
registries | قائمة كائنات | دائمًا | |
registries[].value | سلسلة نصية | دائمًا | رمز سجل. |
registries[].companies | عدد صحيح | دائمًا | عدد الشركات التي يضمها. |
built_ | تاريخ ووقت | اختياري | وقت آخر إعادة بناء لجدول أداة الفرز. |
max_ | عدد صحيح | اختياري | أكثر عدد من عوامل التصفية يقبله الفرز. |
max_ | عدد صحيح | اختياري | أكثر عدد من الشركات تضمه الصفحة. |
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_. استدعاء واحد لكل شركة موجودة.
قيمة period هي annual ما لم تحددها. تحمل الإجابة صفوف الفترة التي طلبتها تحت هذا الاسم، الأحدث أولًا، وصفوف ttm تحت ttm.
السعر استدعاء واحد لكل شركة موجودة، بحد أقصى 10. والطلب الذي لا يجد شيئًا مجاني.
MCP: الأداة filings_.
المعلمات
| معلمة | الموضع | مطلوب | النوع | المعنى |
|---|---|---|---|---|
tickers | body | نعم | list of string | معرّفات الشركات (usa:0000320193)، أو رموز تداول مع السجل (usa:AAPL وjpn:7203)، أو رموز التداول الأمريكية المجردة (AAPL). |
line_ | body | نعم | list of string | أسماء البنود الموحّدة، كما في fields في مسار القوائم المالية. |
period | body | لا | one of annual, semiannual, quarterly, ttm | ttm هو آخر أربعة أرباع مجمعة عند نهاية كل ربع (بنود الميزانية العمومية هي بنود الربع الأخير؛ والشركة التي تقدّم إفصاحاتها سنويًا فقط تحصل على سنواتها المالية). والباقي كما في مسار القوائم المالية. |
start_ | body | لا | التاريخ | الفترات المنتهية في هذا اليوم أو بعده فقط. |
end_ | body | لا | التاريخ | الفترات المنتهية في هذا اليوم أو قبله فقط. |
limit | body | لا | عدد صحيح | عدد الفترات لكل شركة، الأحدث أولًا. الافتراضي: 1، أو كل فترة في نطاق التواريخ (بحد أقصى 40) عند تحديد تاريخ. |
حقول الاستجابة
| حقل | النوع | يُرسل | المعنى |
|---|---|---|---|
results | قائمة كائنات | دائمًا | |
results[].id | سلسلة نصية | دائمًا | معرّف الشركة. |
results[].currency | سلسلة نصية | اختياري | عملة الأرقام. |
results[].basis | one of consolidated, standalone | اختياري | هل الأرقام موحّدة أم منفردة. |
results[].from_ | عدد صحيح | اختياري | أول سنة مالية تعود إليها الصفوف. |
results[].annual | قائمة كائنات | اختياري | الصفوف السنوية، الأحدث أولًا. تُرسل عندما تكون period هي annual. |
results[].annual[].fy | عدد صحيح | دائمًا | السنة المالية للصف. |
results[].annual[].fq | عدد صحيح | اختياري | الربع المالي، لصف ربعي. |
results[].annual[].fh | عدد صحيح | اختياري | النصف المالي، لصف نصف سنوي. |
results[].annual[].end | التاريخ | دائمًا | آخر يوم في الفترة. |
results[].annual[].form | سلسلة نصية | اختياري | نموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_ مختلفة. |
results[].annual[].currency | سلسلة نصية | اختياري | عملة الأسعار. |
results[].annual[].derived | list 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_ مختلفة. |
results[].semiannual[].currency | سلسلة نصية | اختياري | عملة الأسعار. |
results[].semiannual[].derived | list 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_ مختلفة. |
results[].quarterly[].currency | سلسلة نصية | اختياري | عملة الأسعار. |
results[].quarterly[].derived | list of string | اختياري | بنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح. |
results[].as_ | التاريخ | اختياري | اليوم الذي تُعد الأرقام كما هي فيه، حيث تطلب الفترة ذلك. |
results[].ttm | قائمة كائنات | اختياري | صفوف آخر أربعة أرباع، الأحدث أولًا. تُرسل عندما تكون period هي ttm. |
results[].ttm[].fy | عدد صحيح | دائمًا | السنة المالية للصف. |
results[].ttm[].fq | عدد صحيح | اختياري | الربع المالي، لصف ربعي. |
results[].ttm[].fh | عدد صحيح | اختياري | النصف المالي، لصف نصف سنوي. |
results[].ttm[].end | التاريخ | دائمًا | آخر يوم في الفترة. |
results[].ttm[].form | سلسلة نصية | اختياري | نموذج الإفصاح الذي يوفّر معظم القيم التي يعرضها الصف، مثل 10-K. وعند التعادل يفوز الأحدث تقديمًا. لا تُحتسب إلا الحقول التي طلبتها، لذا قد يختلف form بين طلبين لهما line_ مختلفة. |
results[].ttm[].currency | سلسلة نصية | اختياري | عملة الأسعار. |
results[].ttm[].derived | list of string | اختياري | بنود الصف التي حسبها Narwhal بدلًا من أخذها من الإفصاح. |
not_ | list 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_. راجع أخطاء API والرصيد لمعرفة الشكل وترويسات الرصيد. لا تُحاسَب الطلبات الفاشلة.
| الرمز | الحالة | المعنى |
|---|---|---|
invalid_ | 400 | معامل مفقود أو غير معروف أو مكرر أو خارج نطاقه. |
invalid_ | 400 | مؤشر الصفحة هذا لم يُعده هذا الطلب، أو أنه من طلب مختلف. |
insufficient_ | 402 | رصيدك أقل من تكلفة الطلب. |
screener_ | 503 | لم يُبنَ جدول أداة الفرز الليلي بعد. حاول مرة أخرى لاحقًا. لا يُحاسَب هذا. |
company_ | 503 | تعذرت قراءة فرز `as_of` في الوقت المناسب. حاول مرة أخرى بعد قليل. لا يُحاسَب هذا. |
هل كانت هذه الصفحة مفيدة؟