Bull & Bear Analysis

Retrieve AI-generated bullish and bearish investment arguments for a specific stock. Review both sides of the investment thesis for balanced decision-making.

Use Case: Show pros and cons analysis card with 3 bull points and 3 bear points for Tesla.

GET /v1/signals/bull-bear

Get Bull & Bear Analysis

cURL

curl --request GET \
  --url https://api.aries.com/v1/signals/bull-bear \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aries.com/v1/signals/bull-bear"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/signals/bull-bear', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aries.com/v1/signals/bull-bear",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aries.com/v1/signals/bull-bear"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/signals/bull-bear")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/signals/bull-bear")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

success

{
  "bullBearCases": [
    {
      "id": "69489ba01f09b06edf352b9a",
      "ticker": "AAPL",
      "bullCase": "Apple's financial performance shows robust growth, with F4Q25 sales increasing by 8% to $102.5 billion, closely aligning with estimates and reflecting strong iPhone sales anticipated to grow by double digits year-over-year in F1Q26. The services segment also displayed impressive performance, growing 15% year-over-year, which positively influences overall gross margin as the company shifts its focus toward a higher-margin services mix. Additionally, projections for sales growth of 10% to 12% for the upcoming quarter are bolstered by a strong demand for iPhone 17, particularly in the recovering Chinese market, alongside substantial investments in AI and product development indicated by a 19% increase in operating expenses.",
      "bearCase": "Apple's sales in China experienced a decline of 3.6% year-over-year, signaling potential challenges in one of its key markets. The company's consolidated gross margin guidance for the first fiscal quarter of 2026 remains flat year-over-year at the high end of 47%, which, coupled with higher operating expenses, may strain profitability. Concerns over iPhone sales performance and the possibility of a slowdown in growth further contribute to a negative outlook on the company's stock valuation.",
      "securities": [
        {
          "cik": "0000320193",
          "exchange": "NASDAQ Global Select Consolidated",
          "isin": "US0378331005",
          "name": "APPLE INC",
          "symbol": "AAPL"
        }
      ],
      "updated": 1766366112
    }
  ]
}

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

symbols · string · required

Comma-separated list of ticker symbols

Example:

"AAPL,MSFT"

page · integer · default: 0

Page number for pagination (0-based)

Required range: x >= 0

pageSize · integer · default: 100

Number of results per page. Use this to control pagination size in list views. (1-200)

Required range: 1 <= x <= 200

Response

200

application/json

Bull and bear cases.

bullBearCases · object[]

Array of bull and bear investment cases for securities

Show child attributes