Fundamental-ratio percentiles within the S&P 500 GICS sector

GET

/api/v1/equities/{symbol}/sector-percentiles

Last modified:2026-07-19 17:02:27

Maintainer:Not configured

OperationId:equities_symbol_sector_percentiles

Peer-comparison companion to /{symbol}/earnings-quality. For an S&P 500 member, each fundamental ratio is built from single-concept SEC XBRL frames (one value per filer), joined by CIK, filtered to the company's GICS sector, and percentile-ranked (mid-rank tie-breaking; lower-is-better ratios are inverted so a higher percentile always means higher quality). v1 scope: S&P 500 members only - GICS sector classification is licensed and used only where the constituents blob already ships it. Per-metric peer coverage is reported; calendar-year frames omit non-calendar fiscal-year filers. MODEL ESTIMATE from public filings, not investment advice.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/equities/AAPL/sector-percentiles?year=2024' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

The company's ROA, margins, asset turnover, accruals ratio and leverage, each percentile-ranked against its S&P 500 sector peers (higher percentile = higher quality).

Bodyapplication/json

Example

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴502Bad Gateway

🔴503Service Unavailable

Modified at 2026-07-19 17:02:27

Earnings quality score (Piotroski, Sloan, Beneish)

US bank branch locations (FDIC BankFind)