Skip to main content
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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
object[]
required

An array of filter objects to apply to the search.

Minimum array length: 1
period
enum<string>
default:ttm

The time period for the financial data.

Available options:
annual,
quarterly,
ttm
limit
integer
default:100

The maximum number of results to return.

Required range: 1 <= x <= 100
order_by
enum<string>
default:ticker

The field to order the results by. Use -field to order in descending order.

Available options:
ticker,
-ticker,
report_period,
-report_period
currency
enum<string>

The currency of the financial data.

Available options:
USD,
EUR,
GBP,
JPY,
CHF,
AUD,
CAD,
SEK
historical
boolean
default:false

Whether to return historical financial data.

Response

Successful search response

results
object[]

Stocks matching the requested screener filters.