Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Search specific financial metrics

服务器:https://openapi.felo.ai
客户端库

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

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.

请求体·SearchLineItemsRequest
必填
application/json
  • line_items
    类型: array string[] 1…
    必填

    An array of line items to apply to the search.

  • tickers
    类型: array string[] 1…
    必填

    An array of tickers to apply to the search.

  • limit
    类型: integer
    最小值:  
    1

    The maximum number of results to return.

  • period
    类型: string 枚举

    The time period for the financial data.

    值
    • annual
    • quarterly
    • ttm
响应
  • 200
    类型: object · FinancialsSearchResponse

    Successful search response

    • search_results
      类型: array object[]
      • currency
        类型: string

        The currency of the financial data.

      • period
        类型: string 枚举

        The time period of the financial data.

        值
        • annual
        • quarterly
        • ttm
      • report_period
        类型: string 格式: date

        The reporting period of the financial data.

      • ticker
        类型: string

        The ticker symbol of the company.

      • propertyName
        类型: string

        Additional financial metrics based on the search criteria.

    application/json
  • 400
    类型: object · ErrorResponse

    Bad request

    • error
      类型: string

      A short error message.

    • message
      类型: string

      A more detailed error message.

    application/json
  • 401
    类型: object · ErrorResponse

    Unauthorized

    • error
      类型: string

      A short error message.

    • message
      类型: string

      A more detailed error message.

    application/json
  • 402
    类型: object · ErrorResponse

    The request requires a paid subscription

    • error
      类型: string

      A short error message.

    • message
      类型: string

      A more detailed error message.

    application/json
  • 403

    The account is not permitted to perform this operation.

  • 404
    类型: object · ErrorResponse

    The specified resource was not found

    • error
      类型: string

      A short error message.

    • message
      类型: string

      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.

Request Example for post/v1/beta/financial/financials/search/line-items
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "line_items": [
    ""
  ],
  "tickers": [
    ""
  ],
  "period": "ttm",
  "limit": 1
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-09-30",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search specific financial metrics