Financial Data
Company fundamentals, financial statements, market prices and economic data.
Tìm kiếm báo cáo tài chính
Tìm các ticker khớp với điều kiện số. Nội dung yêu cầu nhận filters — mỗi bộ gồm field, operator và value — cùng limit. Trả về results với ticker, currency, sector, industry và trường đã lọc khớp. Đây là công cụ duy nhất ở đây hoạt động mà không cần biết trước ticker; mọi công cụ khác đều nhận ticker làm đầu vào. Các trường có thể lọc là tên chỉ số mà get_financial_financial_metrics trả về. Dùng để lập danh sách ứng viên, rồi lấy chi tiết từng mã bằng công cụ báo cáo hoặc chỉ số.
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 object[] 1…filtersbắt buộc
Mảng các đối tượng bộ lọc cần áp dụng cho tìm kiếm.
- fieldKiểu: stringbắt buộc
Tiêu chí để lọc. Với các trường chỉ số tài chính, dùng toán tử 'gt', 'lt', 'gte', 'lte', 'eq'. Với trường 'ticker' và 'cik', dùng toán tử 'in' để lọc theo nhiều giá trị.
- operatorKiểu: string enumbắt buộc
Toán tử so sánh. Toán tử 'in' chỉ dùng được với giá trị trường 'ticker' hoặc 'cik' và cho phép lọc theo nhiều giá trị.
giá trị- gt
- lt
- gte
- lte
- eq
- in
- valuebắt buộc
- Kiểu: number
Giá trị để so sánh với các toán tử một giá trị (gt, lt, gte, lte, eq)
- Kiểu: integerlimittối thiểu:1
Số lượng kết quả tối đa cần trả về.
- 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/screener \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"limit": 10,
"filters": [
{
"field": "",
"operator": "gt",
"value": 1
}
]
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}