Financial Data
Company fundamentals, financial statements, market prices and economic data.
دریافت همه صورت‌های مالی
هر سه صورت مالی یک شرکت در یک فراخوانی. یک شیء financials برمی‌گرداند که income_statements، balance_sheets و cash_flow_statements را در خود دارد، هر یک به همان شکلی که ابزارهای اختصاصی برمی‌گردانند. period الزامی است (annual، quarterly یا ttm)؛ شرکت را با ticker یا cik شناسایی کنید و با limit محدود کنید. وقتی به تصویر کامل نیاز دارید و در غیر این صورت سه فراخوانی می‌کردید از آن استفاده کنید. وقتی فقط یک صورت می‌خواهید، get_financial_financials_income_statements، get_financial_financials_balance_sheets یا get_financial_financials_cash_flow_statements داده بسیار کمتری برمی‌گردانند؛ وقتی چند فیلد نام‌دار از چند شرکت می‌خواهید، post_financial_financials_search_line_items باز هم باریک‌تر است.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: stringcik
کلید شاخص مرکزی (CIK) شرکت.
- نوع: stringcursor
نشانگر صفحه‌بندی مبهم از next_page_url یک پاسخ قبلی. در صورت ارائه، همه پارامترهای دیگر کوئری نادیده گرفته می‌شوند: نشانگر فیلترهای درخواست اصلی را حمل می‌کند. آن را مبهم در نظر بگیرید؛ آن را نسازید یا تغییر ندهید.
- نوع: string قالب: datefiling
_date فیلتر بر اساس تاریخ دقیق ثبت SEC به قالب YYYY-MM-DD. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: string قالب: datefiling
_date _gt فیلتر بر اساس تاریخ ثبت SEC بزرگ‌تر از تاریخ به قالب YYYY-MM-DD. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: string قالب: datefiling
_date _gte فیلتر بر اساس تاریخ ثبت SEC بزرگ‌تر یا مساوی تاریخ به قالب YYYY-MM-DD. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: string قالب: datefiling
_date _lt فیلتر بر اساس تاریخ ثبت SEC کوچک‌تر از تاریخ به قالب YYYY-MM-DD. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: string قالب: datefiling
_date _lte فیلتر بر اساس تاریخ ثبت SEC کوچک‌تر یا مساوی تاریخ به قالب YYYY-MM-DD. برای کوئری‌های point-in-time مفید است: فقط داده‌هایی را برمی‌گرداند که تا تاریخ داده‌شده به‌صورت عمومی ثبت شده‌اند. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: integer قالب: int32limit
حداکثر تعداد صورت‌های مالی برای بازگرداندن. این مجموع در همه صفحه‌هاست، نه اندازه صفحه: هر صفحه تا 10 رکورد دارد که با
next_page_urlبه هم مرتبط‌اند. - نوع: string فهرست مقادیرperiodالزامی
دوره زمانی صورت‌های مالی.
مقادیر- annual
- quarterly
- ttm
- نوع: string قالب: datereport
_period فیلتر بر اساس تاریخ دقیق دوره گزارش به قالب YYYY-MM-DD.
- نوع: string قالب: datereport
_period _gt فیلتر بر اساس دوره گزارش بزرگ‌تر از تاریخ در قالب YYYY-MM-DD.
- نوع: string قالب: datereport
_period _gte فیلتر بر اساس دوره گزارش بزرگ‌تر یا مساوی تاریخ در قالب YYYY-MM-DD.
- نوع: string قالب: datereport
_period _lt فیلتر بر اساس دوره گزارش کوچک‌تر از تاریخ در قالب YYYY-MM-DD.
- نوع: string قالب: datereport
_period _lte فیلتر بر اساس دوره گزارش کوچک‌تر یا مساوی تاریخ در قالب YYYY-MM-DD.
- نوع: stringticker
نماد تیکر. اگر cik ارائه نشود الزامی است.
- نوع: object · ResponseE40Feb4D3D6B_FinancialsResponse200
پاسخ صورت‌های مالی
- نوع: objectfinancials
- balanceنوع: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accessionنوع: string | null
_number شماره الحاق SEC اظهارنامه.
- accumulatedنوع: number
_other _comprehensive _income سود جامع سایر انباشته شرکت.
- cashنوع: number
_and _equivalents نقد و معادل نقد شرکت.
- currencyنوع: string
واحد پولی که داده‌های مالی به آن گزارش می‌شوند.
- currentنوع: number
_assets دارایی‌های جاری شرکت.
- currentنوع: number
_debt بدهی جاری شرکت.
- currentنوع: number
_investments سرمایه‌گذاری‌های جاری شرکت.
- currentنوع: number
_liabilities بدهی‌های جاری شرکت.
- deferredنوع: number
_revenue درآمد معوق شرکت.
- depositنوع: number
_liabilities بدهی‌های سپرده شرکت.
- filingنوع: string | null قالب: date
_date روز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با
filing_datetime. Null وقتی هیچ اظهارنامه SEC تاریخ‌دار به ردیف مرتبط نیست. - filingنوع: string | null قالب: date-time
_datetime مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد
acceptanceDateTimeدر EDGAR submissions API مربوط به SEC. همراه باfiling_date(دقت روز تقویمی برای همان رویداد). - filingنوع: string | null قالب: uri
_url نشانی URL اظهارنامه SEC.
- fiscalنوع: string
_period دوره مالی ترازنامه.
- formنوع: string | null
_type فرم SEC که این ردیف از آن گرفته شده است (
10-K،10-Q/A،20-F،S-1، ...). فرم دقیق همان‌گونه که ثبت شده، بنابراین اصلاحیه‌ها پسوند/Aخود را حفظ می‌کنند. Null وقتیperiodبرابرttmاست: پنجره دوازده ماهه متحرک می‌تواند چند اظهارنامه را در بر بگیرد، پس آن را به یک اظهارنامه نسبت نمی‌دهیم. یک ردیفquarterlyمی‌تواند10-Kداشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود. - goodwillنوع: number
_and _intangible _assets سرقفلی و دارایی‌های نامشهود شرکت.
- inventoryنوع: number
موجودی شرکت.
- investmentsنوع: number
سرمایه‌گذاری‌های شرکت.
- nonنوع: number
_current _assets دارایی‌های غیرجاری شرکت.
- nonنوع: number
_current _debt بدهی غیرجاری شرکت.
- nonنوع: number
_current _investments سرمایه‌گذاری‌های غیرجاری شرکت.
- nonنوع: number
_current _liabilities بدهی‌های غیرجاری شرکت.
- outstandingنوع: number
_shares سهام در گردش شرکت.
- periodنوع: string فهرست مقادیر
بازه زمانی ترازنامه.
مقادیر- quarterly
- ttm
- annual
- propertyنوع: number
_plant _and _equipment املاک، تأسیسات و تجهیزات شرکت.
- reportنوع: string قالب: date
_period دوره گزارش ترازنامه.
- retainedنوع: number
_earnings سود انباشته شرکت.
- shareholdersنوع: number
_equity حقوق صاحبان سهام شرکت.
- taxنوع: number
_assets دارایی‌های مالیاتی شرکت.
- taxنوع: number
_liabilities بدهی‌های مالیاتی شرکت.
- tickerنوع: string
نماد تیکر.
- totalنوع: number
_assets کل دارایی‌های شرکت.
- totalنوع: number
_debt کل بدهی شرکت.
- totalنوع: number
_liabilities کل بدهی‌های شرکت.
- tradeنوع: number
_and _non _trade _payables حساب‌های پرداختنی تجاری و غیرتجاری شرکت.
- tradeنوع: number
_and _non _trade _receivables حساب‌های دریافتنی تجاری و غیرتجاری شرکت.
- cashنوع: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accessionنوع: string | null
_number شماره الحاق SEC اظهارنامه.
- businessنوع: number
_acquisitions _and _disposals تحصیل و واگذاری کسب‌وکارهای شرکت.
- capitalنوع: number
_expenditure هزینه سرمایه‌ای شرکت.
- changeنوع: number
_in _cash _and _equivalents تغییر در نقد و معادل نقد شرکت.
- currencyنوع: string
واحد پولی که داده‌های مالی به آن گزارش می‌شوند.
- depreciationنوع: number
_and _amortization استهلاک و مستهلک‌سازی شرکت.
- dividendsنوع: number
_and _other _cash _distributions سود سهام و سایر توزیع‌های نقدی شرکت.
- effectنوع: number
_of _exchange _rate _changes اثر تغییرات نرخ ارز شرکت.
- endingنوع: number
_cash _balance مانده نقد پایان دوره شرکت.
- filingنوع: string | null قالب: date
_date روز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با
filing_datetime. Null وقتی هیچ اظهارنامه SEC تاریخ‌دار به ردیف مرتبط نیست. - filingنوع: string | null قالب: date-time
_datetime مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد
acceptanceDateTimeدر EDGAR submissions API مربوط به SEC. همراه باfiling_date(دقت روز تقویمی برای همان رویداد). - filingنوع: string | null قالب: uri
_url نشانی URL اظهارنامه SEC.
- fiscalنوع: string
_period دوره مالی صورت جریان نقدی.
- formنوع: string | null
_type فرم SEC که این ردیف از آن گرفته شده است (
10-K،10-Q/A،20-F،S-1، ...). فرم دقیق همان‌گونه که ثبت شده، بنابراین اصلاحیه‌ها پسوند/Aخود را حفظ می‌کنند. Null وقتیperiodبرابرttmاست: پنجره دوازده ماهه متحرک می‌تواند چند اظهارنامه را در بر بگیرد، پس آن را به یک اظهارنامه نسبت نمی‌دهیم. یک ردیفquarterlyمی‌تواند10-Kداشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود. - freeنوع: number
_cash _flow جریان نقدی آزاد شرکت.
- investmentنوع: number
_acquisitions _and _disposals تحصیل و واگذاری سرمایه‌گذاری‌های شرکت.
- issuanceنوع: number
_or _purchase _of _equity _shares انتشار یا خرید سهام سرمایه شرکت.
- issuanceنوع: number
_or _repayment _of _debt _securities انتشار یا بازپرداخت اوراق بدهی شرکت.
- netنوع: number
_cash _flow _from _financing جریان نقدی خالص از تأمین مالی شرکت.
- netنوع: number
_cash _flow _from _investing جریان نقدی خالص از سرمایه‌گذاری شرکت.
- netنوع: number
_cash _flow _from _operations جریان نقدی خالص از عملیات شرکت.
- netنوع: number
_income سود خالص شرکت.
- periodنوع: string فهرست مقادیر
بازه زمانی صورت جریان نقدی.
مقادیر- quarterly
- ttm
- annual
- reportنوع: string قالب: date
_period دوره گزارش صورت جریان نقدی.
- shareنوع: number
_based _compensation پاداش مبتنی بر سهام شرکت.
- tickerنوع: string
نماد تیکر.
- incomeنوع: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accessionنوع: string | null
_number شماره الحاق SEC اظهارنامه.
- consolidatedنوع: number
_income درآمد تلفیقی شرکت.
- costنوع: number
_of _revenue بهای درآمد شرکت.
- currencyنوع: string
واحد پولی که داده‌های مالی به آن گزارش می‌شوند.
- dividendsنوع: number
_per _common _share سود سهام به ازای هر سهم عادی شرکت.
- earningsنوع: number
_per _share سود هر سهم شرکت.
- earningsنوع: number
_per _share _diluted سود رقیق‌شده هر سهم شرکت.
- ebitنوع: number
سود قبل از بهره و مالیات شرکت.
- filingنوع: string | null قالب: date
_date روز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با
filing_datetime. Null وقتی هیچ اظهارنامه SEC تاریخ‌دار به ردیف مرتبط نیست. - filingنوع: string | null قالب: date-time
_datetime مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد
acceptanceDateTimeدر EDGAR submissions API مربوط به SEC. همراه باfiling_date(دقت روز تقویمی برای همان رویداد). - filingنوع: string | null قالب: uri
_url نشانی URL اظهارنامه SEC.
- fiscalنوع: string
_period دوره مالی صورت سود و زیان.
- formنوع: string | null
_type فرم SEC که این ردیف از آن گرفته شده است (
10-K،10-Q/A،20-F،S-1، ...). فرم دقیق همان‌گونه که ثبت شده، بنابراین اصلاحیه‌ها پسوند/Aخود را حفظ می‌کنند. Null وقتیperiodبرابرttmاست: پنجره دوازده ماهه متحرک می‌تواند چند اظهارنامه را در بر بگیرد، پس آن را به یک اظهارنامه نسبت نمی‌دهیم. یک ردیفquarterlyمی‌تواند10-Kداشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود. - grossنوع: number
_profit سود ناخالص شرکت.
- incomeنوع: number
_tax _expense هزینه‌های مالیات بر درآمد شرکت.
- interestنوع: number
_expense هزینه‌های بهره شرکت.
- netنوع: number
_income سود خالص شرکت.
- netنوع: number
_income _common _stock سود خالص قابل تخصیص به سهامداران عادی شرکت.
- netنوع: number
_income _discontinued _operations سود خالص از عملیات متوقف‌شده شرکت.
- netنوع: number
_income _non _controlling _interests سود خالص از منافع غیرکنترلی شرکت.
- operatingنوع: number
_expense هزینه‌های عملیاتی شرکت.
- operatingنوع: number
_income درآمد عملیاتی شرکت.
- periodنوع: string فهرست مقادیر
بازه زمانی صورت سود و زیان.
مقادیر- quarterly
- ttm
- annual
- preferredنوع: number
_dividends _impact اثر سود سهام ممتاز بر سود خالص شرکت.
- reportنوع: string قالب: date
_period دوره گزارش صورت سود و زیان.
- researchنوع: number
_and _development هزینه‌های تحقیق و توسعه شرکت.
- revenueنوع: number
کل درآمد شرکت.
- sellingنوع: number
_general _and _administrative _expenses هزینه‌های فروش، عمومی و اداری شرکت.
- tickerنوع: string
نماد تیکر.
- weightedنوع: number
_average _shares میانگین موزون سهام شرکت.
- weightedنوع: number
_average _shares _diluted میانگین موزون رقیق‌شده سهام شرکت.
- نوع: stringnext
_page _url نشانی URL مطلق صفحه بعدی نتایج. فقط زمانی وجود دارد که نتایج بیشتری باقی مانده باشد؛ برای ادامه آن را همان‌گونه که هست درخواست کنید. هر صفحه تا 10 رکورد نگه می‌دارد.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"financials": {
"income_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"revenue": 1,
"cost_of_revenue": 1,
"gross_profit": 1,
"operating_expense": 1,
"selling_general_and_administrative_expenses": 1,
"research_and_development": 1,
"operating_income": 1,
"interest_expense": 1,
"ebit": 1,
"income_tax_expense": 1,
"net_income_discontinued_operations": 1,
"net_income_non_controlling_interests": 1,
"net_income": 1,
"net_income_common_stock": 1,
"preferred_dividends_impact": 1,
"consolidated_income": 1,
"earnings_per_share": 1,
"earnings_per_share_diluted": 1,
"dividends_per_common_share": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1
}
],
"balance_sheets": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"total_assets": 1,
"current_assets": 1,
"cash_and_equivalents": 1,
"inventory": 1,
"current_investments": 1,
"trade_and_non_trade_receivables": 1,
"non_current_assets": 1,
"property_plant_and_equipment": 1,
"goodwill_and_intangible_assets": 1,
"investments": 1,
"non_current_investments": 1,
"outstanding_shares": 1,
"tax_assets": 1,
"total_liabilities": 1,
"current_liabilities": 1,
"current_debt": 1,
"trade_and_non_trade_payables": 1,
"deferred_revenue": 1,
"deposit_liabilities": 1,
"non_current_liabilities": 1,
"non_current_debt": 1,
"tax_liabilities": 1,
"shareholders_equity": 1,
"retained_earnings": 1,
"accumulated_other_comprehensive_income": 1,
"total_debt": 1
}
],
"cash_flow_statements": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"period": "quarterly",
"currency": "string",
"accession_number": null,
"form_type": null,
"filing_url": null,
"filing_date": null,
"filing_datetime": null,
"net_income": 1,
"depreciation_and_amortization": 1,
"share_based_compensation": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"business_acquisitions_and_disposals": 1,
"investment_acquisitions_and_disposals": 1,
"net_cash_flow_from_investing": 1,
"issuance_or_repayment_of_debt_securities": 1,
"issuance_or_purchase_of_equity_shares": 1,
"dividends_and_other_cash_distributions": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"effect_of_exchange_rate_changes": 1,
"ending_cash_balance": 1,
"free_cash_flow": 1
}
]
},
"next_page_url": "string"
}