Financial Data
Company fundamentals, financial statements, market prices and economic data.
دریافت تصویر لحظه‌ای سود
سود گزارش‌شده برای یک سهم، واقعی در برابر برآورد. هر ورودی report_period، fiscal_period، filing_date، filing_url و accession_number، یک بلوک quarterly با revenue، estimated_revenue، revenue_surprise و revenue_surprise_pct، همان سه‌گانه برای earnings_per_share و فیلدهای تغییر سال‌به‌سال را دارد. همچنین signals را برمی‌گرداند: نشانه‌های محاسبه‌شده در بالادست مانند EPS_BEAT با headline و actual / estimate / surprise_pct پشت آن. ticker الزامی است و تنها پارامتر است. از آن برای آنچه شرکت واقعاً گزارش کرده استفاده کنید. برای اجماع پیش‌رو که هنوز رخ نداده از get_financial_analyst_estimates استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: stringcursor
نشانگر صفحه‌بندی مبهم از next_page_url یک پاسخ قبلی. در صورت ارائه، همه پارامترهای دیگر کوئری نادیده گرفته می‌شوند: نشانگر فیلترهای درخواست اصلی را حمل می‌کند. آن را مبهم در نظر بگیرید؛ آن را نسازید یا تغییر ندهید.
- نوع: integerlimitحداقل:1حداکثر:40
تعداد دوره‌های گزارش اخیر که اظهارنامه‌هایشان بازگردانده می‌شود، مرتب‌شده بر اساس
(report_period DESC, filing_date ASC). ممکن است تعداد ورودی‌های بازگردانده‌شده ازlimitبیشتر شود وقتی یک دوره اخیر هم 8-K و هم 10-Q / 10-K دارد. مقادیر بالای 40 به 40 محدود می‌شوند. مقادیر غیرمثبت یا غیرصحیح 400 برمی‌گردانند. این مجموع در همه صفحه‌هاست، نه اندازه صفحه: هر صفحه تا 10 رکورد دارد که باnext_page_urlبه هم مرتبط‌اند. - نوع: stringtickerالزامی
نماد تیکر (مثلاً
AAPL).
- نوع: object · ResponseE40Feb4D3D6B_EarningsResponse200
پاسخ سود
- نوع: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]earnings
فهرست مسطح اظهارنامه‌های SEC برای تیکر، مرتب‌شده بر اساس (report_period DESC, filing_date ASC). با
limit=N، اظهارنامه‌های تا N دوره report_period بازگردانده می‌شود؛ تعداد ورودی‌ها می‌تواند از N بیشتر شود وقتی یک دوره اخیر هم 8-K و هم 10-Q/10-K دارد.- accessionنوع: string
_number الزامیشماره الحاق SEC که اظهارنامه را مشخص می‌کند.
- filingنوع: string قالب: date
_date الزامیروز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با
filing_datetime. - filingنوع: string قالب: uri
_url الزامینشانی URL اظهارنامه SEC.
- reportنوع: string قالب: date
_period الزامیدوره گزارشی که این اظهارنامه پوشش می‌دهد.
- sourceنوع: string فهرست مقادیر
_type الزامینوع فرم SEC که این اظهارنامه بر آن مبتنی است.
مقادیر- 8
- K - 10
- Q - 10
- K - 20
- F
- tickerنوع: stringالزامی
نماد تیکر درخواستی.
- annualنوع: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capitalنوع: number | null
_expenditure - capitalنوع: number
_expenditure _chg درصد تغییر هزینه سرمایه‌ای نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- capitalنوع: number
_expenditure _yoy _chg تغییر سال‌به‌سال هزینه سرمایه‌ای نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- cashنوع: number | null
_and _equivalents - changeنوع: number | null
_in _cash _and _equivalents - earningsنوع: number | null
_per _share - earningsنوع: number
_per _share _chg درصد تغییر سود هر سهم (EPS) نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- earningsنوع: number
_per _share _yoy _chg تغییر سال‌به‌سال سود هر سهم (EPS) نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- freeنوع: number | null
_cash _flow - freeنوع: number
_cash _flow _chg درصد تغییر جریان نقدی آزاد نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- freeنوع: number
_cash _flow _yoy _chg تغییر سال‌به‌سال جریان نقدی آزاد نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin حاشیه سود ناخالص به‌صورت اعشاری (gross_profit / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود ناخالص نسبت به دوره قبل بر حسب واحد پایه (مثلاً 200.0 = گسترش 200 bps در حاشیه). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _chg _pct درصد تغییر حاشیه سود ناخالص نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number | null
_profit - grossنوع: number
_profit _chg درصد تغییر سود ناخالص نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_profit _yoy _chg تغییر سال‌به‌سال سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _financing - netنوع: number
_cash _flow _from _financing _chg درصد تغییر جریان نقدی خالص از تأمین مالی نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _financing _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از تأمین مالی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _investing - netنوع: number
_cash _flow _from _investing _chg درصد تغییر جریان نقدی خالص از سرمایه‌گذاری نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _investing _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از سرمایه‌گذاری نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _operations - netنوع: number
_cash _flow _from _operations _chg درصد تغییر جریان نقدی خالص از عملیات نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _operations _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از عملیات نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_income - netنوع: number
_income _chg درصد تغییر سود خالص نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_income _yoy _chg تغییر سال‌به‌سال سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin حاشیه سود خالص به‌صورت اعشاری (net_income / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود خالص نسبت به دوره قبل بر حسب واحد پایه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _chg _pct درصد تغییر حاشیه سود خالص نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number | null
_income - operatingنوع: number
_income _chg درصد تغییر درآمد عملیاتی نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_income _yoy _chg تغییر سال‌به‌سال درآمد عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin حاشیه سود عملیاتی به‌صورت اعشاری (operating_income / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود عملیاتی نسبت به دوره قبل بر حسب واحد پایه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _chg _pct درصد تغییر حاشیه سود عملیاتی نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- revenueنوع: number | null
- revenueنوع: number
_chg درصد تغییر درآمد نسبت به دوره قبل به‌صورت اعشاری (مثلاً 0.10 = +10%). در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- revenueنوع: number
_yoy _chg تغییر سال‌به‌سال درآمد نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- shareholdersنوع: number | null
_equity - totalنوع: number | null
_assets - totalنوع: number | null
_debt - totalنوع: number | null
_liabilities - weightedنوع: number | null
_average _shares - weightedنوع: number | null
_average _shares _diluted
- currencyنوع: string
کد ارز ISO (مثلاً USD).
- filingنوع: string | null قالب: date-time
_datetime مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد
acceptanceDateTimeدر EDGAR submissions API مربوط به SEC. همراه باfiling_date(دقت روز تقویمی برای همان رویداد). - filingنوع: string | null فهرست مقادیر
_window جلسه بازار در لحظه پذیرش اظهارنامه توسط SEC، محاسبه‌شده به وقت شرقی. PRE_MARKET = روز هفته 04:00–09:30 ET. DURING_MARKET = روز هفته 09:30–16:00 ET. AFTER_HOURS = روز هفته خارج از ساعات معاملات عادی. WEEKEND = شنبه یا یکشنبه. Null وقتی filing_datetime در دسترس نیست.
مقادیر- P
R E _ M A R K E T - D
U R I N G _ M A R K E T - A
F T E R _ H O U R S - W
E E K E N D
- fiscalنوع: string
_period برچسب دوره مالی (مثلاً 2026-Q1 یا 2025-FY).
- quarterlyنوع: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
- capitalنوع: number | null
_expenditure - capitalنوع: number
_expenditure _chg درصد تغییر هزینه سرمایه‌ای نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- capitalنوع: number
_expenditure _yoy _chg تغییر سال‌به‌سال هزینه سرمایه‌ای نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- cashنوع: number | null
_and _equivalents - changeنوع: number | null
_in _cash _and _equivalents - earningsنوع: number | null
_per _share - earningsنوع: number
_per _share _chg درصد تغییر سود هر سهم (EPS) نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- earningsنوع: number
_per _share _yoy _chg تغییر سال‌به‌سال سود هر سهم (EPS) نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- freeنوع: number | null
_cash _flow - freeنوع: number
_cash _flow _chg درصد تغییر جریان نقدی آزاد نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- freeنوع: number
_cash _flow _yoy _chg تغییر سال‌به‌سال جریان نقدی آزاد نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin حاشیه سود ناخالص به‌صورت اعشاری (gross_profit / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود ناخالص نسبت به دوره قبل بر حسب واحد پایه (مثلاً 200.0 = گسترش 200 bps در حاشیه). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _chg _pct درصد تغییر حاشیه سود ناخالص نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number | null
_profit - grossنوع: number
_profit _chg درصد تغییر سود ناخالص نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- grossنوع: number
_profit _yoy _chg تغییر سال‌به‌سال سود ناخالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _financing - netنوع: number
_cash _flow _from _financing _chg درصد تغییر جریان نقدی خالص از تأمین مالی نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _financing _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از تأمین مالی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _investing - netنوع: number
_cash _flow _from _investing _chg درصد تغییر جریان نقدی خالص از سرمایه‌گذاری نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _investing _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از سرمایه‌گذاری نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_cash _flow _from _operations - netنوع: number
_cash _flow _from _operations _chg درصد تغییر جریان نقدی خالص از عملیات نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_cash _flow _from _operations _yoy _chg تغییر سال‌به‌سال جریان نقدی خالص از عملیات نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number | null
_income - netنوع: number
_income _chg درصد تغییر سود خالص نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_income _yoy _chg تغییر سال‌به‌سال سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin حاشیه سود خالص به‌صورت اعشاری (net_income / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود خالص نسبت به دوره قبل بر حسب واحد پایه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _chg _pct درصد تغییر حاشیه سود خالص نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- netنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود خالص نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number | null
_income - operatingنوع: number
_income _chg درصد تغییر درآمد عملیاتی نسبت به دوره قبل به‌صورت اعشاری. در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_income _yoy _chg تغییر سال‌به‌سال درآمد عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin حاشیه سود عملیاتی به‌صورت اعشاری (operating_income / revenue). فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _chg _bps تغییر مطلق حاشیه سود عملیاتی نسبت به دوره قبل بر حسب واحد پایه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _chg _pct درصد تغییر حاشیه سود عملیاتی نسبت به دوره قبل به‌صورت اعشاری. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _yoy _chg _bps تغییر سال‌به‌سال حاشیه سود عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، بر حسب واحد پایه. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- operatingنوع: number
_margin _yoy _chg _pct درصد تغییر سال‌به‌سال حاشیه سود عملیاتی نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- revenueنوع: number | null
- revenueنوع: number
_chg درصد تغییر درآمد نسبت به دوره قبل به‌صورت اعشاری (مثلاً 0.10 = +10%). در بدنه پاسخ سه‌ماهه متوالی و در بدنه پاسخ سالانه سال‌به‌سال است. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- revenueنوع: number
_yoy _chg تغییر سال‌به‌سال درآمد نسبت به همان سه‌ماهه مالی یک سال قبل، به‌صورت اعشاری. فقط در بدنه پاسخ سه‌ماهه. فقط زمانی بازگردانده می‌شود که قابل محاسبه باشد.
- shareholdersنوع: number | null
_equity - totalنوع: number | null
_assets - totalنوع: number | null
_debt - totalنوع: number | null
_liabilities - weightedنوع: number | null
_average _shares - weightedنوع: number | null
_average _shares _diluted
- signalsنوع: array object[] · ResponseE40Feb4D3D6B_Signal[]
بینش‌های گزیده و بازارمحور که از این اظهارنامه استخراج شده‌اند. هر آیتم یک
headlineاز پیش آماده،detailsساختاریافته و رتبه‌بندیimportanceدارد. فقط زمانی بازگردانده می‌شود که حداقل یک نشانه برای این ورودی فعال شود؛ در غیر این صورت فیلد حذف می‌شود. حداکثر 8 مورد در هر ورودی، به ترتیب HIGH → MEDIUM → LOW.بینش گزیده و بازارمحور برگرفته از این اظهارنامه.
headlineاز پیش آماده برای نمایش مستقیم مناسب است؛detailsفیلدهای ساختاریافته برای فیلتر و استفاده برنامه‌نویسی را دارد. نشانه‌ها به ترتیب اولویت (مهم‌ترین ابتدا) بازگردانده می‌شوند؛ خودtypeبزرگی را رمزگذاری می‌کند (مثلاًSTRONG_REVENUE_INCREASEدر برابرREVENUE_INCREASE).- headlineنوع: stringالزامی
خلاصه از پیش آماده و خوانا، مناسب برای نمایش مستقیم.
- typeنوع: string فهرست مقادیرالزامی
دسته نشانه. MARGIN_EXPANSION/MARGIN_CONTRACTION: هر یک از حاشیه‌های سود ناخالص/عملیاتی/خالص سال‌به‌سال به میزان ≥100bps حرکت کرده است. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: تغییر راهنمای آینده که در اظهارنامه گزارش شده است. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: بهترین یا بدترین بخش قابل گزارش بر اساس رشد درآمد ارگانیک. NON_GAAP_DIVERGENCE: رقم تعدیل‌شده/non-GAAP به‌طور معنادار با همتای GAAP خود در همان دوره تفاوت دارد. BACKLOG_SURGE/BACKLOG_DECLINE: کارهای انباشته یا تعهدات عملکرد باقی‌مانده سال‌به‌سال به میزان ≥20% حرکت کرده است. REVENUE_INCREASE/STRONG_REVENUE_INCREASE و گونه‌های DECLINE: تغییر پله‌ای درآمد سال‌به‌سال (≥10% / ≥20% از نظر بزرگی). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE و گونه‌های DECLINE: تغییر پله‌ای سود خالص سال‌به‌سال (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE و گونه‌های DECLINE: تغییر پله‌ای سود هر سهم سال‌به‌سال (≥15% / ≥30%)؛ مستقل از سود خالص زیرا بازخرید سهام می‌تواند حرکت سود هر سهم را تقویت کند. CAPEX_INCREASE/STRONG_CAPEX_INCREASE و گونه‌های DECLINE: تغییر پله‌ای هزینه سرمایه‌ای سال‌به‌سال از نظر بزرگی هزینه (≥15% / ≥30%).
مقادیر- M
A R G I N _ E X P A N S I O N - M
A R G I N _ C O N T R A C T I O N - G
U I D A N C E _ R A I S E D - G
U I D A N C E _ L O W E R E D - G
U I D A N C E _ R E A F F I R M E D
- detailsنوع: object
فیلدهای ساختاریافته مخصوص نوع نشانه. محتوا متفاوت است: نشانه‌های راهنما
low،high،point_estimate،prior_value،revision_pctرا دارند؛ نشانه‌های بخشbest،worst،spread_ppرا دارند؛ نشانه‌های non-GAAPgaap_field،non_gaap_value،gaap_value،divergence_pctرا دارند؛ نشانه‌های رشدcurrent،yoy_chgرا دارند. مقادیر Null حذف می‌شوند. به نمونه‌های مخصوص هر نوع مراجعه کنید.- propertyنوع: anything
Name
- metricنوع: string | null
شاخصی که این نشانه به آن ارجاع می‌دهد، در صورت کاربرد (مثلاً
revenue،earnings_per_share،operating_margin، یا نام شاخص راهنما/KPI). - periodنوع: string | null
دوره مالی که نشانه به آن ارجاع می‌دهد (مثلاً
2026-Q1،FY 2026). نشانه‌های راهنمای آینده به دوره راهنمایی‌شده ارجاع می‌دهند؛ نشانه‌های مالی به دوره گزارش این اظهارنامه ارجاع می‌دهند.
- نوع: 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/earnings?ticker=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"earnings": [
{
"ticker": "string",
"report_period": "2026-10-26",
"fiscal_period": "string",
"currency": "string",
"source_type": "8-K",
"filing_date": "2026-10-26",
"filing_datetime": null,
"filing_window": "PRE_MARKET",
"signals": [
{
"type": "MARGIN_EXPANSION",
"metric": null,
"period": null,
"headline": "string",
"details": {
"additionalProperty": "anything"
}
}
],
"filing_url": "https://example.com",
"accession_number": "string",
"quarterly": {
"revenue": null,
"revenue_chg": 1,
"revenue_yoy_chg": 1,
"earnings_per_share": null,
"earnings_per_share_chg": 1,
"earnings_per_share_yoy_chg": 1,
"gross_profit": null,
"gross_profit_chg": 1,
"gross_profit_yoy_chg": 1,
"gross_margin": 1,
"gross_margin_chg_bps": 1,
"gross_margin_chg_pct": 1,
"gross_margin_yoy_chg_bps": 1,
"gross_margin_yoy_chg_pct": 1,
"operating_income": null,
"operating_income_chg": 1,
"operating_income_yoy_chg": 1,
"operating_margin": 1,
"operating_margin_chg_bps": 1,
"operating_margin_chg_pct": 1,
"operating_margin_yoy_chg_bps": 1,
"operating_margin_yoy_chg_pct": 1,
"net_income": null,
"net_income_chg": 1,
"net_income_yoy_chg": 1,
"net_margin": 1,
"net_margin_chg_bps": 1,
"net_margin_chg_pct": 1,
"net_margin_yoy_chg_bps": 1,
"net_margin_yoy_chg_pct": 1,
"weighted_average_shares": null,
"weighted_average_shares_diluted": null,
"cash_and_equivalents": null,
"change_in_cash_and_equivalents": null,
"total_debt": null,
"total_assets": null,
"total_liabilities": null,
"shareholders_equity": null,
"net_cash_flow_from_operations": null,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_operations_yoy_chg": 1,
"net_cash_flow_from_investing": null,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_investing_yoy_chg": 1,
"net_cash_flow_from_financing": null,
"net_cash_flow_from_financing_chg": 1,
"net_cash_flow_from_financing_yoy_chg": 1,
"capital_expenditure": null,
"capital_expenditure_chg": 1,
"capital_expenditure_yoy_chg": 1,
"free_cash_flow": null,
"free_cash_flow_chg": 1,
"free_cash_flow_yoy_chg": 1
},
"annual": {
"revenue": null,
"revenue_chg": 1,
"revenue_yoy_chg": 1,
"earnings_per_share": null,
"earnings_per_share_chg": 1,
"earnings_per_share_yoy_chg": 1,
"gross_profit": null,
"gross_profit_chg": 1,
"gross_profit_yoy_chg": 1,
"gross_margin": 1,
"gross_margin_chg_bps": 1,
"gross_margin_chg_pct": 1,
"gross_margin_yoy_chg_bps": 1,
"gross_margin_yoy_chg_pct": 1,
"operating_income": null,
"operating_income_chg": 1,
"operating_income_yoy_chg": 1,
"operating_margin": 1,
"operating_margin_chg_bps": 1,
"operating_margin_chg_pct": 1,
"operating_margin_yoy_chg_bps": 1,
"operating_margin_yoy_chg_pct": 1,
"net_income": null,
"net_income_chg": 1,
"net_income_yoy_chg": 1,
"net_margin": 1,
"net_margin_chg_bps": 1,
"net_margin_chg_pct": 1,
"net_margin_yoy_chg_bps": 1,
"net_margin_yoy_chg_pct": 1,
"weighted_average_shares": null,
"weighted_average_shares_diluted": null,
"cash_and_equivalents": null,
"change_in_cash_and_equivalents": null,
"total_debt": null,
"total_assets": null,
"total_liabilities": null,
"shareholders_equity": null,
"net_cash_flow_from_operations": null,
"net_cash_flow_from_operations_chg": 1,
"net_cash_flow_from_operations_yoy_chg": 1,
"net_cash_flow_from_investing": null,
"net_cash_flow_from_investing_chg": 1,
"net_cash_flow_from_investing_yoy_chg": 1,
"net_cash_flow_from_financing": null,
"net_cash_flow_from_financing_chg": 1,
"net_cash_flow_from_financing_yoy_chg": 1,
"capital_expenditure": null,
"capital_expenditure_chg": 1,
"capital_expenditure_yoy_chg": 1,
"free_cash_flow": null,
"free_cash_flow_chg": 1,
"free_cash_flow_yoy_chg": 1
}
}
],
"next_page_url": "string"
}