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

Lấy chỉ số tài chính

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

Financial Data

​

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

Financial Data Thao tác

Lấy chỉ số tài chính

​

Tỷ số được tính cho một công ty theo thời gian, khoảng 49 tỷ số mỗi kỳ: 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, các tỷ số vòng quay và thanh khoản, mỗi tỷ số được gắn report_period và fiscal_period. period là bắt buộc; xác định bằng ticker hoặc cik. Dùng để xem xu hướng một tỷ số qua các kỳ. Chỉ cần giá trị hiện tại thì get_financial_financial_metrics_snapshot là một hàng và nhỏ hơn nhiều.

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
  • cik
    Kiểu: string

    Central Index Key (CIK) của công ty. Có thể dùng thay cho ticker.

  • cursor
    Kiểu: string

    Con trỏ phân trang không trong suốt từ next_page_url của phản hồi trước. Khi được cung cấp, mọi tham số truy vấn khác đều bị bỏ qua: con trỏ mang theo các bộ lọc của yêu cầu gốc. Hãy đối xử với nó như một giá trị không trong suốt; không tự tạo hoặc sửa đổi.

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

    Lọc theo ngày nộp hồ sơ SEC chính xác ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.

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

    Lọc theo ngày nộp hồ sơ SEC muộn hơn ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.

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

    Lọc theo ngày nộp hồ sơ SEC muộn hơn hoặc bằng ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.

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

    Lọc theo ngày nộp hồ sơ SEC sớm hơn ngày ở định dạng YYYY-MM-DD. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.

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

    Lọc theo ngày nộp hồ sơ SEC sớm hơn hoặc bằng ngày ở định dạng YYYY-MM-DD. Hữu ích cho truy vấn theo thời điểm: chỉ trả về dữ liệu đã được nộp công khai trước ngày đã cho. Các hàng không có ngày nộp hồ sơ đã biết sẽ bị loại trừ.

  • limit
    Kiểu: integer

    Số kết quả tối đa cần trả về. Đây là tổng trên tất cả các trang, không phải kích thước trang: mỗi trang chứa tối đa 10 bản ghi, liên kết qua next_page_url.

  • period
    Kiểu: string enum
    bắt buộc

    Khoảng thời gian của dữ liệu tài chính.

    giá trị
    • annual
    • quarterly
    • ttm
  • report_period
    Kiểu: string Định dạng: date

    Lọc theo ngày kỳ báo cáo chính xác ở định dạng YYYY-MM-DD.

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

    Lọc theo kỳ báo cáo lớn hơn ngày ở định dạng YYYY-MM-DD.

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

    Lọc theo kỳ báo cáo lớn hơn hoặc bằng ngày ở định dạng YYYY-MM-DD.

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

    Lọc theo kỳ báo cáo nhỏ hơn ngày ở định dạng YYYY-MM-DD.

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

    Lọc theo kỳ báo cáo nhỏ hơn hoặc bằng ngày ở định dạng YYYY-MM-DD.

  • ticker
    Kiểu: string

    Mã ticker của công ty. Bắt buộc nếu không cung cấp cik.

Phản hồi
  • 200
    Kiểu: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Các chỉ số và tỷ số tài chính lịch sử của một ticker

    • accession_number
      Kiểu: string | null

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

    • asset_turnover
      Kiểu: number

      Doanh thu chia cho tổng tài sản bình quân.

    • book_value_growth
      Kiểu: number

      Tăng trưởng giá trị sổ sách so với cùng kỳ năm trước.

    • book_value_per_share
      Kiểu: number

      Vốn chủ sở hữu của cổ đông chia cho số cổ phiếu đang lưu hành.

    • cash_ratio
      Kiểu: number

      Tiền và các khoản tương đương tiền chia cho nợ phải trả ngắn hạn.

    • currency
      Kiểu: string

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

    • current_ratio
      Kiểu: number

      Tài sản ngắn hạn chia cho nợ phải trả ngắn hạn.

    • days_sales_outstanding
      Kiểu: number

      Các khoản phải thu bình quân chia cho doanh thu trong kỳ.

    • debt_to_assets
      Kiểu: number

      Tổng nợ chia cho tổng tài sản.

    • debt_to_equity
      Kiểu: number

      Tổng nợ chia cho vốn chủ sở hữu của cổ đông.

    • earnings_growth
      Kiểu: number

      Tăng trưởng lợi nhuận so với cùng kỳ năm trước.

    • earnings_per_share
      Kiểu: number

      Lợi nhuận ròng chia cho số cổ phiếu đang lưu hành bình quân gia quyền.

    • earnings_per_share_growth
      Kiểu: number

      Tăng trưởng thu nhập trên mỗi cổ phiếu trong kỳ.

    • ebitda_growth
      Kiểu: number

      Tăng trưởng EBITDA trong kỳ.

    • enterprise_value
      Kiểu: number

      Tổng giá trị của công ty (vốn hóa thị trường + nợ - tiền mặt).

    • enterprise_value_to_ebitda_ratio
      Kiểu: number

      Tỷ lệ giá trị doanh nghiệp trên EBITDA.

    • enterprise_value_to_revenue_ratio
      Kiểu: number

      Tỷ lệ giá trị doanh nghiệp trên doanh thu.

    • 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 các chỉ số tài chính.

    • 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.

    • free_cash_flow_growth
      Kiểu: number

      Tăng trưởng dòng tiền tự do trong kỳ.

    • free_cash_flow_per_share
      Kiểu: number

      Dòng tiền tự do chia cho số cổ phiếu đang lưu hành.

    • free_cash_flow_yield
      Kiểu: number

      Tỷ suất dòng tiền tự do.

    • gross_margin
      Kiểu: number

      Lợi nhuận gộp tính theo phần trăm doanh thu.

    • interest_coverage
      Kiểu: number

      EBIT chia cho chi phí lãi vay.

    • inventory_turnover
      Kiểu: number

      Giá vốn hàng bán chia cho hàng tồn kho bình quân.

    • net_margin
      Kiểu: number

      Lợi nhuận ròng tính theo phần trăm doanh thu.

    • 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.

    • operating_cash_flow_ratio
      Kiểu: number

      Dòng tiền từ hoạt động kinh doanh chia cho nợ phải trả ngắn hạn.

    • operating_cycle
      Kiểu: number

      Vòng quay hàng tồn kho + vòng quay khoản phải thu.

    • operating_income_growth
      Kiểu: number

      Tăng trưởng lợi nhuận hoạt động trong kỳ.

    • operating_margin
      Kiểu: number

      Lợi nhuận hoạt động tính theo phần trăm doanh thu.

    • payout_ratio
      Kiểu: number

      Cổ tức đã trả tính theo phần trăm lợi nhuận ròng.

    • peg_ratio
      Kiểu: number

      Tỷ lệ giá trên tăng trưởng thu nhập.

    • period
      Kiểu: string enum

      Khoảng thời gian của các chỉ số tài chính.

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

      Tỷ lệ giá trên giá trị sổ sách.

    • price_to_earnings_ratio
      Kiểu: number

      Tỷ lệ giá trên thu nhập.

    • price_to_sales_ratio
      Kiểu: number

      Tỷ lệ giá trên doanh thu.

    • quick_ratio
      Kiểu: number

      Tài sản nhanh chia cho nợ phải trả ngắn hạn.

    • receivables_turnover
      Kiểu: number

      Doanh thu chia cho các khoản phải thu bình quân.

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

      Kỳ báo cáo của các chỉ số tài chính.

    • return_on_assets
      Kiểu: number

      Lợi nhuận ròng tính theo phần trăm tổng tài sản.

    • return_on_equity
      Kiểu: number

      Lợi nhuận ròng tính theo phần trăm vốn chủ sở hữu của cổ đông.

    • return_on_invested_capital
      Kiểu: number

      Lợi nhuận hoạt động ròng sau thuế tính theo phần trăm vốn đầu tư.

    • revenue_growth
      Kiểu: number

      Tăng trưởng doanh thu so với cùng kỳ năm trước.

    • ticker
      Kiểu: string

      Mã ticker của công ty.

    • working_capital_turnover
      Kiểu: number

      Doanh thu chia cho vốn lưu động bình quân.

    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/financial-metrics
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"
}

Các chỉ số và tỷ số tài chính lịch sử của một ticker

Get financial metrics