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

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.

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

{
    "data": {
        "symbol": "AAPL",
        "cik": "string",
        "sector": "Information Technology",
        "peer_universe": "S&P 500",
        "sector_size": 0,
        "frame_year": 0,
        "metrics": {
            "property1": {
                "value": 0,
                "percentile": 0,
                "sector_median": 0,
                "peers_with_data": 0,
                "label": "string",
                "property1": "string",
                "property2": "string"
            },
            "property2": {
                "value": 0,
                "percentile": 0,
                "sector_median": 0,
                "peers_with_data": 0,
                "label": "string",
                "property1": "string",
                "property2": "string"
            }
        },
        "methodology": {
            "property1": "string",
            "property2": "string"
        },
        "property1": "string",
        "property2": "string"
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴502Bad Gateway

🔴503Service Unavailable

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

Request

Request Code Samples

Responses