Market Breadth

Retrieve market breadth indicators including advancing vs declining stocks, new highs vs new lows, and up vs down volume. Assess overall market health and participation to validate trend strength and identify potential reversals.

Use Case: Display a market breadth dashboard showing advance/decline ratio to gauge whether rallies are broad-based or narrow.

GET /v1/analytics/market-breadth

Get Market Breadth

cURL

curl --request GET \
  --url https://api.aries.com/v1/analytics/market-breadth \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "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

200

application/json

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.

Show child attributes

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
}