Financial Data
Company fundamentals, financial statements, market prices and economic data.
دریافت معیارهای مالی
نسبت‌های محاسبه‌شده برای یک شرکت در طول زمان، حدود 49 در هر دوره: market_cap، enterprise_value، price_to_earnings_ratio، price_to_book_ratio، price_to_sales_ratio، enterprise_value_to_ebitda_ratio، free_cash_flow_yield، peg_ratio، gross_margin، operating_margin، net_margin، return_on_equity، return_on_assets، return_on_invested_capital، نسبت‌های گردش و نقدینگی، هر یک با report_period و fiscal_period مهر شده. period الزامی است؛ با ticker یا cik شناسایی کنید. از آن برای روند یک نسبت در دوره‌ها استفاده کنید. فقط برای مقادیر فعلی، get_financial_financial_metrics_snapshot یک ردیف و بسیار کوچک‌تر است.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 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 مفید است: فقط داده‌هایی را برمی‌گرداند که تا تاریخ داده‌شده به‌صورت عمومی ثبت شده‌اند. ردیف‌هایی که تاریخ ثبت شناخته‌شده ندارند حذف می‌شوند.
- نوع: integerlimit
حداکثر تعداد نتایج برای بازگرداندن. این مجموع در همه صفحه‌هاست، نه اندازه صفحه: هر صفحه تا 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_FinancialMetricsResponse200
معیارها و نسبت‌های مالی تاریخی یک ticker
- نوع: string | nullaccession
_number شماره الحاق SEC اظهارنامه.
- نوع: numberasset
_turnover درآمد تقسیم بر میانگین کل دارایی‌ها.
- نوع: numberbook
_value _growth رشد سال‌به‌سال ارزش دفتری.
- نوع: number
حقوق صاحبان سهام تقسیم بر سهام در گردش.
- نوع: numbercash
_ratio نقد و معادل نقد تقسیم بر بدهی‌های جاری.
- نوع: stringcurrency
واحد پولی که داده‌های مالی به آن گزارش می‌شوند.
- نوع: numbercurrent
_ratio دارایی‌های جاری تقسیم بر بدهی‌های جاری.
- نوع: numberdays
_sales _outstanding میانگین حساب‌های دریافتنی تقسیم بر درآمد در طول دوره.
- نوع: numberdebt
_to _assets کل بدهی تقسیم بر کل دارایی‌ها.
- نوع: numberdebt
_to _equity کل بدهی تقسیم بر حقوق صاحبان سهام.
- نوع: numberearnings
_growth رشد سال‌به‌سال سود.
- نوع: number
سود خالص تقسیم بر میانگین موزون سهام در گردش.
- نوع: number
رشد سود هر سهم در طول دوره.
- نوع: numberebitda
_growth رشد EBITDA در طول دوره.
- نوع: numberenterprise
_value ارزش کل شرکت (ارزش بازار + بدهی - نقد).
- نوع: numberenterprise
_value _to _ebitda _ratio نسبت ارزش شرکت به EBITDA.
- نوع: numberenterprise
_value _to _revenue _ratio نسبت ارزش شرکت به درآمد.
- نوع: string | null قالب: datefiling
_date روز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با
filing_datetime. Null وقتی هیچ اظهارنامه SEC تاریخ‌دار به ردیف مرتبط نیست. - نوع: string | null قالب: date-timefiling
_datetime مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد
acceptanceDateTimeدر EDGAR submissions API مربوط به SEC. همراه باfiling_date(دقت روز تقویمی برای همان رویداد). - نوع: string | null قالب: urifiling
_url نشانی URL اظهارنامه SEC.
- نوع: stringfiscal
_period دوره مالی شاخص‌های مالی.
- نوع: string | nullform
_type فرم SEC که این ردیف از آن گرفته شده است (
10-K،10-Q/A،20-F،S-1، ...). فرم دقیق همان‌گونه که ثبت شده، بنابراین اصلاحیه‌ها پسوند/Aخود را حفظ می‌کنند. Null وقتیperiodبرابرttmاست: پنجره دوازده ماهه متحرک می‌تواند چند اظهارنامه را در بر بگیرد، پس آن را به یک اظهارنامه نسبت نمی‌دهیم. یک ردیفquarterlyمی‌تواند10-Kداشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود. - نوع: numberfree
_cash _flow _growth رشد جریان نقدی آزاد در طول دوره.
- نوع: number
جریان نقدی آزاد تقسیم بر سهام در گردش.
- نوع: numberfree
_cash _flow _yield بازده جریان نقدی آزاد.
- نوع: numbergross
_margin سود ناخالص به‌عنوان درصدی از درآمد.
- نوع: numberinterest
_coverage EBIT تقسیم بر هزینه بهره.
- نوع: numberinventory
_turnover بهای تمام‌شده کالای فروش‌رفته تقسیم بر میانگین موجودی.
- نوع: numbernet
_margin سود خالص به‌عنوان درصدی از درآمد.
- نوع: stringnext
_page _url نشانی URL مطلق صفحه بعدی نتایج. فقط زمانی وجود دارد که نتایج بیشتری باقی مانده باشد؛ برای ادامه آن را همان‌گونه که هست درخواست کنید. هر صفحه تا 10 رکورد نگه می‌دارد.
- نوع: numberoperating
_cash _flow _ratio جریان نقدی عملیاتی تقسیم بر بدهی‌های جاری.
- نوع: numberoperating
_cycle گردش موجودی + گردش حساب‌های دریافتنی.
- نوع: numberoperating
_income _growth رشد درآمد عملیاتی در طول دوره.
- نوع: numberoperating
_margin درآمد عملیاتی به‌عنوان درصدی از درآمد.
- نوع: numberpayout
_ratio سود سهام پرداختی به‌عنوان درصدی از سود خالص.
- نوع: numberpeg
_ratio نسبت قیمت به رشد سود.
- نوع: string فهرست مقادیرperiod
بازه زمانی شاخص‌های مالی.
مقادیر- quarterly
- ttm
- annual
- نوع: numberprice
_to _book _ratio نسبت قیمت به ارزش دفتری.
- نوع: numberprice
_to _earnings _ratio نسبت قیمت به سود.
- نوع: numberprice
_to _sales _ratio نسبت قیمت به فروش.
- نوع: numberquick
_ratio دارایی‌های سریع تقسیم بر بدهی‌های جاری.
- نوع: numberreceivables
_turnover درآمد تقسیم بر میانگین حساب‌های دریافتنی.
- نوع: string قالب: datereport
_period دوره گزارش شاخص‌های مالی.
- نوع: numberreturn
_on _assets سود خالص به‌عنوان درصدی از کل دارایی‌ها.
- نوع: numberreturn
_on _equity سود خالص به‌عنوان درصدی از حقوق صاحبان سهام.
- نوع: numberreturn
_on _invested _capital سود عملیاتی خالص پس از مالیات به‌عنوان درصدی از سرمایه سرمایه‌گذاری‌شده.
- نوع: numberrevenue
_growth رشد سال‌به‌سال درآمد.
- نوع: stringticker
نماد تیکر شرکت.
- نوع: numberworking
_capital _turnover درآمد تقسیم بر میانگین سرمایه در گردش.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"enterprise_value": 1,
"price_to_earnings_ratio": 1,
"price_to_book_ratio": 1,
"price_to_sales_ratio": 1,
"enterprise_value_to_ebitda_ratio": 1,
"enterprise_value_to_revenue_ratio": 1,
"free_cash_flow_yield": 1,
"peg_ratio": 1,
"gross_margin": 1,
"operating_margin": 1,
"net_margin": 1,
"return_on_equity": 1,
"return_on_assets": 1,
"return_on_invested_capital": 1,
"asset_turnover": 1,
"inventory_turnover": 1,
"receivables_turnover": 1,
"days_sales_outstanding": 1,
"operating_cycle": 1,
"working_capital_turnover": 1,
"current_ratio": 1,
"quick_ratio": 1,
"cash_ratio": 1,
"operating_cash_flow_ratio": 1,
"debt_to_equity": 1,
"debt_to_assets": 1,
"interest_coverage": 1,
"revenue_growth": 1,
"earnings_growth": 1,
"book_value_growth": 1,
"earnings_per_share_growth": 1,
"free_cash_flow_growth": 1,
"operating_income_growth": 1,
"ebitda_growth": 1,
"payout_ratio": 1,
"earnings_per_share": 1,
"book_value_per_share": 1,
"free_cash_flow_per_share": 1,
"next_page_url": "string"
}