Skip to main content
GET
/
v1
/
stocks
/
estimates-guidance
Query Estimates or Guidance
curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/estimates-guidance \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "fiscal_end_date": "2024-12-31",
      "fiscal_period": 1,
      "fiscal_year": 2024,
      "fsym_id": "MH33D6-R",
      "guidance_date": "2024-01-15",
      "guidance_high": 5.5,
      "guidance_low": 5,
      "guidance_midpoint": 5.25,
      "guidance_range": "5.00 - 5.50",
      "mean_before": 5.15,
      "mean_surprise_amt": 0.1,
      "mean_surprise_amt_ratio": 0.0194,
      "metric": "EPS",
      "observed_at": 1705363200,
      "periodicity": "ANN",
      "prev_high": 5.3,
      "prev_low": 4.9,
      "prev_midpoint": 5.1,
      "symbol": "AAPL"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

​
X-API-Key
string
header
required

API Key authentication. Example: "your-api-key-here"

Query Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL)

​
metrics
string
required

Metrics (comma-separated). Supported: EPS, SALES, DPS, CFPS, EBITDA, EBIT, BPS, ASSETS

​
type
enum<string>
required

Data type

Available options:
estimate,
guidance
​
period_type
enum<string>

Period type (default: annual)

Available options:
annual,
quarterly,
semi-annual
​
start_time
integer

Start time for observed_at filter (Unix timestamp in seconds)

​
end_time
integer

End time for observed_at filter (Unix timestamp in seconds)

​
fiscal_year
integer

Fiscal year filter (e.g., 2024)

​
fiscal_quarter
enum<string>

Fiscal quarter

Available options:
Q1,
Q2,
Q3,
Q4
​
limit
integer

Result limit (default: 10, max: 1000)

Response

When type=guidance

​
data
object[]
​
error
object
​
pagination
any
​
request_id
string
​
success
boolean