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

Analyst Estimates

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Financial Data

​

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

Financial Data Operations

Analyst Estimates

​

Forward analyst consensus for one stock: fiscal_period, period, revenue and earnings_per_share per estimated period. ticker is required; period selects annual or quarterly and limit caps how many periods come back. Deliberately narrow — no analyst names, no ratings, no price targets, no high/low dispersion. Use it for what the street expects. For what was actually reported, and by how much it beat or missed, use get_financial_earnings.

Query Parameters
  • ticker
    Type: string
    required

    The ticker to get analyst estimates for.

  • period
    Type: string enum

    The period to get analyst estimates for. Use the /analyst-estimates/periods endpoint to get a list of available periods. Defaults to 'annual'.

    values
    • annual
    • quarterly
  • limit
    Type: integer

    The maximum number of estimates to return (max 3 for annual, 12 for quarterly).

Responses
  • 200
    Type: object · AnalystEstimatesResponse

    Analyst estimates response

    • analyst_estimates
      Type: array object[] · AnalystEstimate[]
      • earnings_per_share
        Type: number

        The estimated earnings per share.

      • fiscal_period
        Type: string Format: date

        The fiscal period of the analyst estimate.

      • period
        Type: string enum

        The period of the analyst estimate.

        values
        • annual
        • quarterly
      • revenue
        Type: integer

        The estimated revenue.

    application/json
  • 400
    Type: object · ErrorResponse

    Bad request

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 401
    Type: object · ErrorResponse

    Unauthorized

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 402
    Type: object · ErrorResponse

    The request requires a paid subscription

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 403

    The account is not permitted to perform this operation.

  • 404
    Type: object · ErrorResponse

    The specified resource was not found

    • error
      Type: string

      A short error message.

    • message
      Type: 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 get/v1/beta/financial/analyst-estimates
curl 'https://openapi.felo.ai/v1/beta/financial/analyst-estimates?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "analyst_estimates": [
    {
      "fiscal_period": "2026-09-30",
      "period": "annual",
      "revenue": 1,
      "earnings_per_share": 1
    }
  ]
}

Analyst estimates response

Analyst Estimates