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.

دریافت ترازنامه‌ها

​

ترازنامه‌های یک شرکت، حدود 36 فیلد در هر دوره: total_assets، current_assets، cash_and_equivalents، inventory، trade_and_non_trade_receivables، property_plant_and_equipment، goodwill_and_intangible_assets، total_liabilities، current_liabilities، current_debt، trade_and_non_trade_payables، deferred_revenue و ردیف‌های حقوق صاحبان سهام، مهرشده با report_period، fiscal_period، currency و filing_url. period انتخاب‌گر است. از آن برای ساختار سرمایه و نقدینگی استفاده کنید. برای نسبت‌هایی که از قبل از این اعداد محاسبه شده‌اند از get_financial_financial_metrics استفاده کنید.

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

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

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

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

    پاسخ ترازنامه‌ها

    • balance_sheets
      نوع: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
      • accession_number
        نوع: string | null

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

      • accumulated_other_comprehensive_income
        نوع: number

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

      • cash_and_equivalents
        نوع: number

        نقد و معادل نقد شرکت.

      • currency
        نوع: string

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

      • current_assets
        نوع: number

        دارایی‌های جاری شرکت.

      • current_debt
        نوع: number

        بدهی جاری شرکت.

      • current_investments
        نوع: number

        سرمایه‌گذاری‌های جاری شرکت.

      • current_liabilities
        نوع: number

        بدهی‌های جاری شرکت.

      • deferred_revenue
        نوع: number

        درآمد معوق شرکت.

      • deposit_liabilities
        نوع: 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 داشته باشد وقتی سه‌ماهه چهارم از اظهارنامه سال مالی استخراج می‌شود.

      • goodwill_and_intangible_assets
        نوع: number

        سرقفلی و دارایی‌های نامشهود شرکت.

      • inventory
        نوع: number

        موجودی شرکت.

      • investments
        نوع: number

        سرمایه‌گذاری‌های شرکت.

      • non_current_assets
        نوع: number

        دارایی‌های غیرجاری شرکت.

      • non_current_debt
        نوع: number

        بدهی غیرجاری شرکت.

      • non_current_investments
        نوع: number

        سرمایه‌گذاری‌های غیرجاری شرکت.

      • non_current_liabilities
        نوع: number

        بدهی‌های غیرجاری شرکت.

      • outstanding_shares
        نوع: number

        سهام در گردش شرکت.

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

        بازه زمانی ترازنامه.

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

        املاک، تأسیسات و تجهیزات شرکت.

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

        دوره گزارش ترازنامه.

      • retained_earnings
        نوع: number

        سود انباشته شرکت.

      • shareholders_equity
        نوع: number

        حقوق صاحبان سهام شرکت.

      • tax_assets
        نوع: number

        دارایی‌های مالیاتی شرکت.

      • tax_liabilities
        نوع: number

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

      • ticker
        نوع: string

        نماد تیکر.

      • total_assets
        نوع: number

        کل دارایی‌های شرکت.

      • total_debt
        نوع: number

        کل بدهی شرکت.

      • total_liabilities
        نوع: number

        کل بدهی‌های شرکت.

      • trade_and_non_trade_payables
        نوع: number

        حساب‌های پرداختنی تجاری و غیرتجاری شرکت.

      • trade_and_non_trade_receivables
        نوع: 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/balance-sheets
curl https://openapi.felo.ai/v1/beta/financial/financials/balance-sheets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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
    }
  ],
  "next_page_url": "string"
}
Get balance sheets