数据 API / Financial Data / Financials

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.

参数

没有路径、查询或请求头参数。

请求体

periodstring可选
允许值： annual · quarterly · ttm
The time period for the financial data.
limitinteger可选
The maximum number of results to return.
order_bystring可选
允许值： ticker · -ticker · report_period · -report_period
The field to order the results by. Use -field to order in descending order.
currencystring可选
允许值： USD · EUR · GBP · JPY · CHF · AUD · CAD · SEK
The currency of the financial data.
historicalboolean可选
Whether to return historical financial data.
filtersobject[]必填
An array of filter objects to apply to the search.
fieldstring必填
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.
operatorstring必填
允许值： gt · lt · gte · lte · eq · in
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.
value必填

请求示例

curl -X POST "https://openapi.felo.ai/v1/beta/financial/financials/search/screener" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "filters": [
    {}
  ],
  "period": "<string>",
  "limit": 0,
  "order_by": "<string>",
  "currency": "<string>",
  "historical": false
}'

响应

响应字段

resultsobject[]可选
Stocks matching the requested screener filters.
tickerstring可选
The ticker symbol of the company.
report_periodstring可选
The reporting period of the financial data.
periodstring可选
允许值： annual · quarterly · ttm
The time period of the financial data.
currencystring可选
The currency of the financial data.