> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Query Estimates or Guidance > [OpenAPI JSON Spec](/docs/output/v1_stocks_estimates-guidance_get.json) Retrieve consensus estimates or company guidance data. **Supported Metrics**: EPS, SALES, DPS, CFPS, EBITDA, EBIT, BPS, ASSETS **Period Type**: annual, quarterly, semi-annual **Type**: - `estimate`: Returns array of EstimateRow (analyst consensus data) - `guidance`: Returns array of GuidanceRow (company-reported guidance) **Pagination**: results are a two-dimensional panel — one row per observation date **per** forecast fiscal period **per** metric — so a single symbol/metric easily exceeds a thousand rows. Page with `limit` + `offset`; the response echoes both under `pagination`. A page shorter than `limit` is the last page. Rows are ordered by observation date descending, then fiscal period end descending, then metric. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/estimates-guidance openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/stocks/estimates-guidance: get: tags: - Stock summary: Query Estimates or Guidance description: |- [OpenAPI JSON Spec](/docs/output/v1_stocks_estimates-guidance_get.json) Retrieve consensus estimates or company guidance data. **Supported Metrics**: EPS, SALES, DPS, CFPS, EBITDA, EBIT, BPS, ASSETS **Period Type**: annual, quarterly, semi-annual **Type**: - `estimate`: Returns array of EstimateRow (analyst consensus data) - `guidance`: Returns array of GuidanceRow (company-reported guidance) **Pagination**: results are a two-dimensional panel — one row per observation date **per** forecast fiscal period **per** metric — so a single symbol/metric easily exceeds a thousand rows. Page with `limit` + `offset`; the response echoes both under `pagination`. A page shorter than `limit` is the last page. Rows are ordered by observation date descending, then fiscal period end descending, then metric. parameters: - description: Stock symbol (e.g., AAPL) in: query name: symbol required: true schema: type: string - description: >- Metrics (comma-separated). Supported: EPS, SALES, DPS, CFPS, EBITDA, EBIT, BPS, ASSETS in: query name: metrics required: true schema: type: string - description: Data type in: query name: type required: true schema: type: string enum: - estimate - guidance - description: 'Period type (default: annual)' in: query name: period_type schema: type: string enum: - annual - quarterly - semi-annual - description: Start time for observed_at filter (Unix timestamp in seconds) in: query name: start_time schema: type: integer - description: End time for observed_at filter (Unix timestamp in seconds) in: query name: end_time schema: type: integer - description: >- Issuer fiscal year filter (e.g., 2026). This is the company's own fiscal year label, not the calendar year of fiscal_end_date -- for a filer whose fiscal year ends in January, the quarter ending 2026-04-30 is fiscal year 2027. Matches the fiscal_year on the 3-statement endpoints. in: query name: fiscal_year schema: type: integer - description: Fiscal quarter in: query name: fiscal_quarter schema: type: string enum: - Q1 - Q2 - Q3 - Q4 - description: 'Page size (default: 10, max: 1000)' in: query name: limit schema: type: integer - description: 'Rows to skip before the page (default: 0)' in: query name: offset schema: type: integer responses: '200': description: When type=guidance content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.FactsetGuidanceRow' type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.FactsetGuidanceRow: properties: fiscal_end_date: description: Fiscal period end date example: '2024-12-31' type: string fiscal_period: description: Fiscal period example: 1 type: integer fiscal_year: description: Issuer fiscal year (not the calendar year of fiscal_end_date) example: 2026 type: integer fsym_id: description: FactSet symbol ID example: MH33D6-R type: string guidance_date: description: Guidance date (YYYY-MM-DD) example: '2024-01-15' type: string guidance_high: description: Guidance high value example: 5.5 type: number guidance_low: description: Guidance low value example: 5 type: number guidance_midpoint: description: Guidance midpoint example: 5.25 type: number guidance_range: description: Guidance range string example: 5.00 - 5.50 type: string mean_before: description: Consensus mean before guidance example: 5.15 type: number mean_surprise_amt: description: Surprise amount vs mean example: 0.1 type: number mean_surprise_amt_ratio: description: Surprise ratio vs mean (decimal, not percentage) example: 0.0194 type: number metric: description: Metric name (e.g., EPS, SALES, EBITDA) example: EPS type: string observed_at: description: Point-in-time observation timestamp (Unix seconds) example: 1705363200 type: integer periodicity: description: 'Periodicity: ANN, QTR, SEMI' example: ANN type: string prev_high: description: Previous guidance high example: 5.3 type: number prev_low: description: Previous guidance low example: 4.9 type: number prev_midpoint: description: Previous guidance midpoint example: 5.1 type: number symbol: description: Stock symbol example: AAPL type: string type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````