Skip to main content
GET
/
v1
/
analytics
/
insights
Get Analyst Insights
curl --request GET \
  --url https://api.aries.com/v1/analytics/insights \
  --header 'Authorization: Bearer <token>'
{
  "insights": [
    {
      "id": "insight-001",
      "date": "2026-01-10",
      "updated": 1736534400,
      "action": "Upgrade",
      "rating": "Buy",
      "ratingId": "r-8821",
      "pt": "210.00",
      "firm": "Demo Research",
      "firmId": "firm-42",
      "analystInsights": "Raised price target on stronger services revenue.",
      "security": {
        "cik": "0000320193",
        "exchange": "NASDAQ",
        "isin": "US0378331005",
        "name": "Apple Inc.",
        "symbol": "AAPL"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

​
page
integer

Zero-based page number. Enter 0 for the first page, 1 for the second page, and so on.

Required range: x >= 0
​
pageSize
integer

Number of results per page. Use this to control pagination size in list views. Use this to control page size; default is 10.

Required range: 1 <= x <= 1000
​
symbols
string

Comma-separated ticker symbols, such as AAPL,MSFT. Use this to request or filter multiple companies in one call. (e.g. AAPL,MSFT)

​
analyst
string

Comma-separated analyst IDs. Use this to limit insight results to specific analysts.

​
ratingId
string

Comma-separated rating IDs. Use this to limit insight results to specific rating records.

​
searchKeysType
enum<string>

Tells the API how to interpret the value you send in searchKeys. Allowed values:

  • firm_id — the value is a firm/company internal ID.
  • firm — the value is the firm/company name.
Available options:
firm_id,
firm
​
searchKeys
string

Search key value (based on searchKeysType)

Response

Analyst insights. Each item may include id, date, updated, action, rating, ratingId, pt, firm, firmId, analystInsights, security (cik, exchange, isin, name, symbol).

​
insights
object[]