Search financial statements
Financial Statements
Stock Screener
Find tickers by numeric conditions — the only tool here that does not need a ticker up front.
POST
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.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
An array of filter objects to apply to the search.
Minimum array length:
1The time period for the financial data.
Available options:
annual, quarterly, ttm The maximum number of results to return.
Required range:
1 <= x <= 100The field to order the results by. Use -field to order in descending order.
Available options:
ticker, -ticker, report_period, -report_period The currency of the financial data.
Available options:
USD, EUR, GBP, JPY, CHF, AUD, CAD, SEK Whether to return historical financial data.
Response
Successful search response
Stocks matching the requested screener filters.