Financial Data
Company fundamentals, financial statements, market prices and economic data.
الحصول على بنود إفصاح SEC
النص الكامل للبنود المرقّمة داخل إفصاح SEC واحد. ticker وfiling_type (10-K أو 10-Q أو 8-K) وyear كلها مطلوبة؛ وضيّق أكثر بـ quarter أو item أو accession_number أو include_exhibits. يعيد items — كل منها مع number وtitle والنص الكامل text — إضافةً إلى filing_url وaccession_number. انتبه إلى الحجم: يعود 10-K بنحو 19 بندًا من النثر الكامل، لذا اطلب item محدّدًا بدلًا من سحب كل شيء ما لم تكن تحتاج المستند كاملًا فعلًا. لمعرفة أي إفصاح تفتح أولًا، استخدم get_financial_filings.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.02 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringaccession
_number رقم الانضمام الخاص بالإيداع إذا كان 8-K.
- النوع: string تعدادfiling
_type مطلوبنوع الإيداع.
القيم- 10
- K - 10
- Q - 8
- K
- النوع: booleaninclude
_exhibits هل يُضمَّن النص الخام من المستندات المرفقة المرتبطة. ينطبق على إيداعات 8-K فقط. عند true، ستتضمن كائنات المستندات المرفقة الحقل 'text' الذي يحتوي محتوى المستند المرفق كاملًا.
- النوع: string تعدادitem
العنصر المراد الحصول عليه.
القيم- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- النوع: integerquarter
ربع الإيداع إذا كان 10-Q.
- النوع: stringtickerمطلوب
رمز السهم.
- النوع: integeryearمطلوب
سنة الإيداع.
- النوع: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
استجابة بنود إفصاح SEC
- النوع: stringaccession
_number رقم الانضمام للإيداع.
- النوع: stringcik
مفتاح الفهرس المركزي (CIK) للشركة.
- النوع: stringfiling
_type نوع الإيداع.
- النوع: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibitsالنوع: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
مصفوفة من المستندات المرفقة المرتبطة بهذا البند. لا تظهر إلا لإيداعات 8-K عندما توجد مستندات مرفقة.
- descriptionالنوع: string
وصف المستند المرفق.
- numberالنوع: string
رقم المستند المرفق (مثل '99.1').
- textالنوع: string
محتوى النص الخام للمستند المرفق. يُضمَّن فقط عندما تكون معلمة 'include_exhibits' مضبوطة على true.
- urlالنوع: string التنسيق: uri
عنوان URL لمستند المستند المرفق على موقع SEC.
- nameالنوع: string
اسم البند.
- numberالنوع: string
رقم البند.
- textالنوع: string
نص البند.
- النوع: integerquarter
ربع الإيداع.
- النوع: stringresource
معرّف نوع المورد.
- النوع: stringticker
رمز سهم الشركة.
- النوع: integeryear
سنة الإيداع.
application/json - النوع: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
لا يزال الإفصاح قيد الإعداد. استطلع result_url من جسم الاستجابة لاسترداد النتيجة. لا تُحتسب عليك رسوم لهذه الاستجابة.
- النوع: stringaccession
_number رقم الانضمام للإيداع قيد الإعداد.
- النوع: string التنسيق: date-timeestimated
_ready _at متى يُتوقع أن يكون الإيداع جاهزًا.
- النوع: stringmessage
وصف مقروء لما يجب فعله بعد ذلك.
- النوع: string التنسيق: uuidrequest
_id معرّف لهذا الطلب؛ مفيد عند التواصل مع الدعم.
- النوع: stringresult
_url عنوان URL للاستقصاء عن النتيجة.
- تعدادstatusثابت:processing
دائمًا 'processing' في استجابة 202.
القيم- processing
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}