Python (SDK)
from finance_dev import FinanceDev, models
import os
with FinanceDev(
security=models.Security(
client_id=os.getenv("FINANCE_DEV_CLIENT_ID", ""),
client_secret=os.getenv("FINANCE_DEV_CLIENT_SECRET", ""),
),
) as fd_client:
res = fd_client.signals.get_bull_bear_analysis(symbols="AAPL,MSFT", page=0, page_size=100)
while res is not None:
# Handle items
res = res.next()curl --request GET \
--url https://api.aries.com/v1/signals/bull-bear \
--header 'Authorization: Bearer <token>'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{
"bullBearCases": [
{
"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.",
"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.",
"id": "69489ba01f09b06edf352b9a",
"securities": [
{
"cik": "0000320193",
"exchange": "NASDAQ Global Select Consolidated",
"isin": "US0378331005",
"name": "APPLE INC",
"symbol": "AAPL"
}
],
"ticker": "AAPL",
"updated": 1766366112
}
]
}Signals
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
Python (SDK)
from finance_dev import FinanceDev, models
import os
with FinanceDev(
security=models.Security(
client_id=os.getenv("FINANCE_DEV_CLIENT_ID", ""),
client_secret=os.getenv("FINANCE_DEV_CLIENT_SECRET", ""),
),
) as fd_client:
res = fd_client.signals.get_bull_bear_analysis(symbols="AAPL,MSFT", page=0, page_size=100)
while res is not None:
# Handle items
res = res.next()curl --request GET \
--url https://api.aries.com/v1/signals/bull-bear \
--header 'Authorization: Bearer <token>'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{
"bullBearCases": [
{
"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.",
"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.",
"id": "69489ba01f09b06edf352b9a",
"securities": [
{
"cik": "0000320193",
"exchange": "NASDAQ Global Select Consolidated",
"isin": "US0378331005",
"name": "APPLE INC",
"symbol": "AAPL"
}
],
"ticker": "AAPL",
"updated": 1766366112
}
]
}Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Query Parameters
Comma-separated list of ticker symbols
Example:
"AAPL,MSFT"
Page number for pagination (0-based)
Required range:
x >= 0Number of results per page. Use this to control pagination size in list views. (1-200)
Required range:
1 <= x <= 200Response
Bull and bear cases.
Bull and bear investment cases for securities.
Array of bull and bear investment cases for securities
Show child attributes
Show child attributes
Was this page helpful?