Felo API PlatformFelo API Platform
Tất cả endpoint của Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Lấy báo cáo thu nhập

Máy chủ:https://openapi.felo.ai
Thư viện client

Financial Data

​

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

Lấy báo cáo thu nhập

​

Báo cáo thu nhập của một công ty, khoảng 32 trường mỗi kỳ: 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 và các dòng trên mỗi cổ phiếu, mỗi dòng được gắn report_period, fiscal_period, currency, filing_date và filing_url. period là bộ chọn (annual, quarterly hoặc ttm). Dùng để đi từ doanh thu đến thu nhập. Để lấy cả ba báo cáo cùng lúc, dùng get_financial_financials.

Tham chiếu giá

  • Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn
  • limit
    Kiểu: string
  • period
    Kiểu: string
  • ticker
    Kiểu: string
Phản hồi
  • 200
    Kiểu: object · ResponseE40Feb4D3D6B_IncomeStatementResponse

    Phản hồi báo cáo thu nhập

    • income_statements
      Kiểu: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
      • accession_number
        Kiểu: string | null

        Số truy cập SEC của hồ sơ.

      • consolidated_income
        Kiểu: number

        Thu nhập hợp nhất của công ty.

      • cost_of_revenue
        Kiểu: number

        Giá vốn của công ty.

      • currency
        Kiểu: string

        Đơn vị tiền tệ mà dữ liệu tài chính được báo cáo.

      • dividends_per_common_share
        Kiểu: number

        Cổ tức trên mỗi cổ phiếu phổ thông của công ty.

      • earnings_per_share
        Kiểu: number

        Thu nhập trên mỗi cổ phiếu của công ty.

      • earnings_per_share_diluted
        Kiểu: number

        Thu nhập pha loãng trên mỗi cổ phiếu của công ty.

      • ebit
        Kiểu: number

        Lợi nhuận trước lãi vay và thuế của công ty.

      • filing_date
        Kiểu: string | null Định dạng: date

        Ngày lịch SEC chấp nhận hồ sơ, theo Giờ miền Đông (múi giờ hoạt động của SEC). Cặp ngày lịch với filing_datetime. Null khi không có hồ sơ SEC có ngày được liên kết với hàng.

      • filing_datetime
        Kiểu: string | null Định dạng: date-time

        Dấu thời gian dưới ngày ghi lại thời điểm SEC chấp nhận hồ sơ, theo Giờ miền Đông. Lấy từ trường acceptanceDateTime của SEC trên API submissions của EDGAR. Đi kèm với filing_date (độ chính xác ngày lịch của cùng sự kiện).

      • filing_url
        Kiểu: string | null Định dạng: uri

        URL tới hồ sơ SEC.

      • fiscal_period
        Kiểu: string

        Kỳ tài chính của báo cáo kết quả hoạt động kinh doanh.

      • form_type
        Kiểu: string | null

        Biểu mẫu SEC mà hàng này được lấy từ (10-K, 10-Q/A, 20-F, S-1, ...). Đúng biểu mẫu như khi nộp, nên các bản sửa đổi giữ hậu tố /A. Null khi period là ttm: cửa sổ mười hai tháng gần nhất có thể trải qua nhiều hồ sơ, nên chúng tôi không gán nó cho một hồ sơ. Một hàng quarterly có thể mang 10-K khi quý thứ tư được suy ra từ hồ sơ năm tài chính.

      • gross_profit
        Kiểu: number

        Lợi nhuận gộp của công ty.

      • income_tax_expense
        Kiểu: number

        Chi phí thuế thu nhập của công ty.

      • interest_expense
        Kiểu: number

        Chi phí lãi vay của công ty.

      • net_income
        Kiểu: number

        Lợi nhuận ròng của công ty.

      • net_income_common_stock
        Kiểu: number

        Lợi nhuận ròng dành cho cổ đông phổ thông của công ty.

      • net_income_discontinued_operations
        Kiểu: number

        Lợi nhuận ròng từ hoạt động đã chấm dứt của công ty.

      • net_income_non_controlling_interests
        Kiểu: number

        Lợi nhuận ròng từ lợi ích không kiểm soát của công ty.

      • operating_expense
        Kiểu: number

        Chi phí hoạt động của công ty.

      • operating_income
        Kiểu: number

        Lợi nhuận hoạt động của công ty.

      • period
        Kiểu: string enum

        Khoảng thời gian của báo cáo kết quả hoạt động kinh doanh.

        giá trị
        • quarterly
        • ttm
        • annual
      • preferred_dividends_impact
        Kiểu: number

        Tác động của cổ tức ưu đãi lên lợi nhuận ròng của công ty.

      • report_period
        Kiểu: string Định dạng: date

        Kỳ báo cáo của báo cáo kết quả hoạt động kinh doanh.

      • research_and_development
        Kiểu: number

        Chi phí nghiên cứu và phát triển của công ty.

      • revenue
        Kiểu: number

        Tổng doanh thu của công ty.

      • selling_general_and_administrative_expenses
        Kiểu: number

        Chi phí bán hàng, chi phí chung và chi phí quản lý của công ty.

      • ticker
        Kiểu: string

        Mã ticker.

      • weighted_average_shares
        Kiểu: number

        Số cổ phiếu bình quân gia quyền của công ty.

      • weighted_average_shares_diluted
        Kiểu: number

        Số cổ phiếu bình quân gia quyền pha loãng của công ty.

    • next_page_url
      Kiểu: string

      URL tuyệt đối của trang kết quả tiếp theo. Chỉ xuất hiện khi còn kết quả; hãy yêu cầu nguyên văn để tiếp tục. Mỗi trang chứa tối đa 10 bản ghi.

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    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