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 historical analyst rating and target price details.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `TSLA.US` |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
evaluate | object | Optional | Rating distribution history |
└ list | object[] | Optional | Daily holding history records |
└ ∟ strong_buy | integer | Optional | Strong buy count |
└ ∟ buy | integer | Optional | Buy count |
└ ∟ hold | integer | Optional | Hold count |
└ ∟ sell | integer | Optional | Sell count |
└ ∟ under | integer | Optional | Underperform count |
└ ∟ date | string | Optional | Date |
target | object | Optional | Target price history |
└ updated_at | string | Optional | Unix timestamp (seconds) of last update |
└ prediction_accuracy | string | Optional | Prediction accuracy. |
└ list | object[] | Optional | Daily holding history records |
└ ∟ timestamp | string | Optional | Unix timestamp |
└ ∟ price | string | Optional | Closing price on that date |
└ ∟ meet | boolean | Optional | Whether price met target |
└ ∟ avg_target | string | Optional | Average target price |
└ ∟ min_target | string | Optional | Lowest target price |
└ ∟ max_target | string | Optional | Highest target price |
└ ∟ date | string | Optional | Date |
└ data_percent | string | Optional | Data completeness percentage. |
ccy_symbol | string | Optional | Currency symbol |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"ccy_symbol": "$",
"evaluate": {
"list": [
{
"date": "2021/05/14",
"buy": 3,
"hold": 11,
"sell": 2,
"strong_buy": 9,
"under": 6
}
]
},
"target": {
"list": [
{
"broker_name": "Goldman Sachs",
"date": "2026-04-30",
"rating": "Buy",
"target_price": "250.00"
}
]
}
}
}Error code
See the Error Codes page for the full list of error codes.