Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get EPS forecasts and analyst consensus estimates.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `TSLA.US` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
items | object[] | Optional | List of EPS forecast periods |
└ forecast_eps_median | string | Optional | Median EPS estimate |
└ forecast_eps_mean | string | Optional | Mean EPS estimate |
└ forecast_eps_lowest | string | Optional | Lowest EPS estimate |
└ forecast_eps_highest | string | Optional | Highest EPS estimate |
└ institution_total | integer | Optional | Total contributing institutions |
└ institution_up | integer | Optional | Institutions revising up |
└ institution_down | integer | Optional | Institutions revising down |
└ forecast_start_date | string | Optional | Forecast period start date |
└ forecast_end_date | string | Optional | Forecast period end date |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"items": [
{
"forecast_end_date": "1727827200",
"forecast_eps_highest": "3.71",
"forecast_eps_lowest": "2.37",
"forecast_eps_mean": "2.998",
"forecast_eps_median": "3.02",
"forecast_start_date": "1727827200",
"institution_down": 0,
"institution_total": 0,
"institution_up": 0
}
]
}
}Error code
See the Error Codes page for the full list of error codes.