Felo API PlatformFelo API Platform
همه endpointهای Financial Data
v0.2.0-beta
OpenAPI 3.1.0

دریافت صورت‌های سود و زیان

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

دریافت صورت‌های سود و زیان

​

صورت‌های سود و زیان یک شرکت، حدود 32 فیلد در هر دوره: revenue، cost_of_revenue، gross_profit، operating_expense، selling_general_and_administrative_expenses، research_and_development، operating_income، interest_expense، ebit، income_tax_expense، net_income، net_income_common_stock و ردیف‌های هر سهم، هر یک مهرشده با report_period، fiscal_period، currency، filing_date و filing_url. period انتخاب‌گر است (annual، quarterly یا ttm). از آن برای مسیر از درآمد به سود استفاده کنید. برای هر سه صورت با هم از get_financial_financials استفاده کنید.

مرجع قیمت‌گذاری

  • اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
  • برآورد درخواست مرجع: 0.02 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو
  • limit
    نوع: string
  • period
    نوع: string
  • ticker
    نوع: string
پاسخ‌ها
  • 200
    نوع: object · ResponseE40Feb4D3D6B_IncomeStatementResponse

    پاسخ صورت‌های سود و زیان

    • income_statements
      نوع: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
      • accession_number
        نوع: string | null

        شماره الحاق SEC اظهارنامه.

      • consolidated_income
        نوع: number

        درآمد تلفیقی شرکت.

      • cost_of_revenue
        نوع: number

        بهای درآمد شرکت.

      • currency
        نوع: string

        واحد پولی که داده‌های مالی به آن گزارش می‌شوند.

      • dividends_per_common_share
        نوع: number

        سود سهام به ازای هر سهم عادی شرکت.

      • earnings_per_share
        نوع: number

        سود هر سهم شرکت.

      • earnings_per_share_diluted
        نوع: number

        سود رقیق‌شده هر سهم شرکت.

      • ebit
        نوع: number

        سود قبل از بهره و مالیات شرکت.

      • filing_date
        نوع: string | null قالب: date

        روز تقویمی که SEC اظهارنامه را پذیرفت، به وقت شرقی (منطقه زمانی عملیاتی SEC). جفت روز تقویمی با filing_datetime. Null وقتی هیچ اظهارنامه SEC تاریخ‌دار به ردیف مرتبط نیست.

      • filing_datetime
        نوع: string | null قالب: date-time

        مهر زمانی زیرروزانه که زمان پذیرش اظهارنامه توسط SEC را ثبت می‌کند، به وقت شرقی. برگرفته از فیلد acceptanceDateTime در EDGAR submissions API مربوط به SEC. همراه با filing_date (دقت روز تقویمی برای همان رویداد).

      • filing_url
        نوع: string | null قالب: uri

        نشانی URL اظهارنامه SEC.

      • fiscal_period
        نوع: string

        دوره مالی صورت سود و زیان.

      • form_type
        نوع: string | null

        فرم SEC که این ردیف از آن گرفته شده است (10-K، 10-Q/A، 20-F، S-1، ...). فرم دقیق همان‌گونه که ثبت شده، بنابراین اصلاحیه‌ها پسوند /A خود را حفظ می‌کنند. Null وقتی period برابر ttm است: پنجره دوازده ماهه متحرک می‌تواند چند اظهارنامه را در بر بگیرد، پس آن را به یک اظهارنامه نسبت نمی‌دهیم. یک ردیف quarterly می‌تواند 10-K داشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود.

      • gross_profit
        نوع: number

        سود ناخالص شرکت.

      • income_tax_expense
        نوع: number

        هزینه‌های مالیات بر درآمد شرکت.

      • interest_expense
        نوع: number

        هزینه‌های بهره شرکت.

      • net_income
        نوع: number

        سود خالص شرکت.

      • net_income_common_stock
        نوع: number

        سود خالص قابل تخصیص به سهامداران عادی شرکت.

      • net_income_discontinued_operations
        نوع: number

        سود خالص از عملیات متوقف‌شده شرکت.

      • net_income_non_controlling_interests
        نوع: number

        سود خالص از منافع غیرکنترلی شرکت.

      • operating_expense
        نوع: number

        هزینه‌های عملیاتی شرکت.

      • operating_income
        نوع: number

        درآمد عملیاتی شرکت.

      • period
        نوع: string فهرست مقادیر

        بازه زمانی صورت سود و زیان.

        مقادیر
        • quarterly
        • ttm
        • annual
      • preferred_dividends_impact
        نوع: number

        اثر سود سهام ممتاز بر سود خالص شرکت.

      • report_period
        نوع: string قالب: date

        دوره گزارش صورت سود و زیان.

      • research_and_development
        نوع: number

        هزینه‌های تحقیق و توسعه شرکت.

      • revenue
        نوع: number

        کل درآمد شرکت.

      • selling_general_and_administrative_expenses
        نوع: number

        هزینه‌های فروش، عمومی و اداری شرکت.

      • ticker
        نوع: string

        نماد تیکر.

      • weighted_average_shares
        نوع: number

        میانگین موزون سهام شرکت.

      • weighted_average_shares_diluted
        نوع: number

        میانگین موزون رقیق‌شده سهام شرکت.

    • next_page_url
      نوع: string

      نشانی URL مطلق صفحه بعدی نتایج. فقط زمانی وجود دارد که نتایج بیشتری باقی مانده باشد؛ برای ادامه آن را همان‌گونه که هست درخواست کنید. هر صفحه تا 10 رکورد نگه می‌دارد.

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for get/v1/beta/financial/financials/income-statements
curl https://openapi.felo.ai/v1/beta/financial/financials/income-statements \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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
    }
  ],
  "next_page_url": "string"
}
Get income statements