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