Financial Data
Company fundamentals, financial statements, market prices and economic data.
Tìm kiếm chỉ số tài chính cụ thể
Lấy các dòng tài chính có tên trên một hoặc nhiều công ty trong một lần gọi. Nội dung yêu cầu nhận tickers và line_items (đều bắt buộc, đều là mảng), cùng period (annual, quarterly hoặc ttm) và limit. Trả về search_results với một hàng cho mỗi ticker và kỳ, chỉ chứa các trường bạn yêu cầu, cùng report_period, period và currency. Dùng để lập bảng so sánh mà không phải lấy ba báo cáo đầy đủ cho mỗi công ty. Tên mục trùng với tên trường mà các công cụ báo cáo trả về, nên nếu chưa chắc hãy tra ở đó trước. Để lấy mọi thứ về một công ty, 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.
- Kiểu: array string[] 1…line
_items bắt buộcMảng các khoản mục cần áp dụng cho tìm kiếm.
- Kiểu: array string[] 1…tickersbắt buộc
Mảng các mã ticker cần áp dụng cho tìm kiếm.
- Kiểu: integerlimittối thiểu:1
Số lượng kết quả tối đa cần trả về.
- Kiểu: string enumperiod
Khoảng thời gian của dữ liệu tài chính.
giá trị- annual
- quarterly
- ttm
- Kiểu: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
Phản hồi tìm kiếm thành công
- Kiểu: array object[]search
_results - currencyKiểu: string
Đơn vị tiền tệ của dữ liệu tài chính.
- periodKiểu: string enum
Khoảng thời gian của dữ liệu tài chính.
giá trị- annual
- quarterly
- ttm
- reportKiểu: string Định dạng: date
_period Kỳ báo cáo của dữ liệu tài chính.
- tickerKiểu: string
Mã ticker của công ty.
- propertyKiểu: string
Name Các chỉ số tài chính bổ sung dựa trên tiêu chí tìm kiếm.
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
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"line_items": [
""
],
"tickers": [
""
],
"period": "ttm",
"limit": 1
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}