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 列挙値必須
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 列挙値currency
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 列挙値order
_by The field to order the results by. Use -field to order in descending order.
値- ticker
- -ticker
- report
_period - -report
_period
- 型: string 列挙値period
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 列挙値
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"
}
]
}