Skip to main content
GET
/
v1
/
analytics
/
market-breadth
Get Market Breadth
curl --request GET \
  --url https://api.aries.com/v1/analytics/market-breadth \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.aries.com/v1/analytics/market-breadth"

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/analytics/market-breadth', 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/analytics/market-breadth",
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/analytics/market-breadth"

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/analytics/market-breadth")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/analytics/market-breadth")

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
{
  "success": true,
  "data": {
    "advanceDeclineRatio": 1.85,
    "advancers": 2840,
    "advancersPercent": 62.5,
    "decliners": 1532,
    "declinersPercent": 33.7,
    "timestamp": "2026-03-09T13:48:11.726532Z",
    "totalSymbols": 4544,
    "unchanged": 172
  }
}

Authorizations

Authorization
string
header
required

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

Response

Market breadth data retrieved successfully

success
boolean
data
object

Market breadth snapshot showing how many symbols are rising, falling, or unchanged. Use it to summarize overall market participation.

Example:
{
"advanceDeclineRatio": 1.85,
"advancers": 2840,
"advancersPercent": 62.5,
"decliners": 1532,
"declinersPercent": 33.7,
"timestamp": "2026-03-09T13:48:11.726532Z",
"totalSymbols": 4544,
"unchanged": 172
}