Programmatic access to the same transparent six-factor ratings you see on the site. Available on Pro. Everything the API returns is research, not investment advice.
Create a key from your account (Pro only). Send it on every request as a bearer token or in the x-api-key header. Keys are shown once at creation — store them securely.
curl https://www.proofstock.com/api/v1/ratings \
-H "Authorization: Bearer psk_your_key_here"https://www.proofstock.com/api/v1/ratingsThe latest ratings across the universe. Query params: limit (1–500, default 100), offset.
/ratings/{ticker}The latest rating, composite percentile, factor z-scores, and rank for one stock.
/ratings/{ticker}/historyThe rating and composite-percentile time series for one stock.
GET /api/v1/ratings/AAPL
{
"as_of": "2026-07-21",
"ticker": "AAPL",
"name": "Apple Inc.",
"sector": "Technology",
"rating": "Bullish",
"composite_percentile": 78,
"factors": {
"momentum": 0.9, "quality": 1.2, "value": -0.4,
"growth": 0.6, "size": -1.8, "low_vol": 0.3
},
"sector_rank": { "rank": 12, "total": 168, "sector": "Technology" },
"overall_rank": { "rank": 271, "total": 1228 }
}Please keep requests reasonable while we’re early — the data updates once per run, so caching responses is encouraged. Redistributing or reselling the data requires written permission (see the Terms). Ratings are research products, not buy/sell signals.