Financial Data
Company fundamentals, financial statements, market prices and economic data.
Search financial statements
Find tickers that match numeric conditions. Body takes filters — each a field, an operator and a value — plus limit. Returns results with ticker, currency, sector, industry and whichever filtered field was matched. This is the only tool here that works without knowing a ticker in advance; everything else takes one as input. Filterable fields are the metric names get_financial_financial_metrics returns. Use it to build a candidate list, then pull detail on each name with the statement or metric tools.
Pricing reference
- Metering: Fixed successful-request cost basis.
- Reference request estimate: USD 0.02.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array object[] 1…filtersrequired
An array of filter objects to apply to the search.
- fieldType: stringrequired
The criteria to filter on. For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators. For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values.
- operatorType: string enumrequired
The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values.
values- gt
- lt
- gte
- lte
- eq
- in
- valuerequired
- Type: number
The value to compare against for single-value operators (gt, lt, gte, lte, eq)
- Type: integerlimitmin:1
The maximum number of results to return.
- Type: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
Successful search response
- Type: array object[]search
_results - currencyType: string
The currency of the financial data.
- periodType: string enum
The time period of the financial data.
values- annual
- quarterly
- ttm
- reportType: string Format: date
_period The reporting period of the financial data.
- tickerType: string
The ticker symbol of the company.
- propertyType: string
Name Additional financial metrics based on the search criteria.
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
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-23",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}