数据 API / Financial Data / Financials

Search specific financial metrics

Pull named financial line items across one or more companies in a single call. Body takes tickers and line_items (both required, both arrays), plus period (annual, quarterly or ttm) and limit. Returns search_results with one row per ticker and period carrying only the fields you asked for, alongside report_period, period and currency. Use it to build a comparison table without pulling three full statements per company. The item names are the same field names the statement tools return, so look one up there first if unsure. For everything about a single company use get_financial_financials.

参数

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

请求体

line_itemsstring[]必填
An array of line items to apply to the search.
tickersstring[]必填
An array of tickers to apply to the search.
periodstring可选
允许值： annual · quarterly · ttm
The time period for the financial data.
limitinteger可选
The maximum number of results to return.

请求示例

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

响应

响应字段

search_resultsobject[]可选
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.