Get Analyst Estimates

Forward analyst consensus for revenue and EPS, by fiscal period.

GET https://api.aisa.one/apis/v1/financial/analyst-estimates

Get Analyst Estimates

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/financial/analyst-estimates \
  --header 'Authorization: Bearer <token>'

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.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: search, list_categories and get_details are free, use and batch_use are billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

• Method and path: GET /apis/v1/financial/analyst-estimates
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/financial/analyst-estimates
• limit: query; optional
• period: query; optional
• ticker: query; optional
• Runtime facts: afe2e5d365275c032408a51b04030fb8f5be4f9d70a476d8735d89f06821a9b8

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_financial_analyst_estimates",
  "method": "GET",
  "path": "/apis/v1/financial/analyst-estimates",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "period",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "ticker",
      "required": false,
      "schema": {
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.02,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.02
• Cost contract: fixed_success
• Published reference multiplier: 1.0
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · string

period · string

ticker · string

Response

200

Successful response