Financial Data
Company fundamentals, financial statements, market prices and economic data.
دریافت صورت‌های جریان نقدی
صورت‌های جریان نقدی یک شرکت، حدود 27 فیلد در هر دوره: net_cash_flow_from_operations، net_cash_flow_from_investing، net_cash_flow_from_financing، capital_expenditure، depreciation_and_amortization، share_based_compensation، issuance_or_repayment_of_debt_securities، issuance_or_purchase_of_equity_shares و dividends_and_other_cash_distributions، مهرشده با report_period، fiscal_period و currency. period الزامی است. از آن برای دیدن تولید نقد استفاده کنید نه سود حسابداری. بازده جریان نقد آزاد و ارقام مشتق مشابه در get_financial_financial_metrics هستند.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 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_CashFlowStatementResponse200
پاسخ صورت‌های جریان نقدی
- نوع: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]cash
_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
نماد تیکر.
- نوع: 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/cash-flow-statements?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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"
}