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.
- Тип: array object[] 1…filtersобязательно
An array of filter objects to apply to the search.
- fieldТип: stringобязательно
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.
- operatorТип: string enumобязательно
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.
значения- gt
- lt
- gte
- lte
- eq
- in
- valueобязательно
- Тип: number
The value to compare against for single-value operators (gt, lt, gte, lte, eq)
- Тип: string enumcurrency
The currency of the financial data.
значения- U
S D - E
U R - G
B P - J
P Y - C
H F - A
U D - C
A D - S
E K
- Тип: booleanhistorical
Whether to return historical financial data.
- Тип: integerlimitмин.:1макс.:100
The maximum number of results to return.
- Тип: string enumorder
_by The field to order the results by. Use -field to order in descending order.
значения- ticker
- -ticker
- report
_period - -report
_period
- Тип: string enumperiod
The time period for the financial data.
значения- annual
- quarterly
- ttm
- Тип: object · FinancialsScreenerResponse200
Successful search response
- Тип: array object[]results
Stocks matching the requested screener filters.
- currencyТип: string
The currency of the financial data.
- periodТип: string enum
The time period of the financial data.
значения- annual
- quarterly
- ttm
- reportТип: string Формат: date
_period The reporting period of the financial data.
- tickerТип: string
The ticker symbol of the company.
- propertyТип: string
Name Additional financial metrics based on the search criteria.
application/json - Тип: object · ErrorResponse400
Bad request
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - Тип: object · ErrorResponse401
Unauthorized
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - Тип: object · ErrorResponse402
The request requires a paid subscription
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - 403
The account is not permitted to perform this operation.
- Тип: object · ErrorResponse404
The specified resource was not found
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - 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
The operation failed. Keep the response request ID when contacting Felo support.
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 '{
"period": "ttm",
"limit": 100,
"order_by": "ticker",
"currency": "USD",
"historical": false,
"filters": [
{
"field": "",
"operator": "gt",
"value": 1
}
]
}'
{
"results": [
{
"ticker": "string",
"report_period": "2026-09-30",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}