API
Our rankings, in your pipeline.
Every week we score 6,158 global stocks across hundreds of factors, grouped into seven categories. The API gives you those scores — and the live holdings of your model portfolios — as plain JSON. No scraping, no CSV shuffling, no waiting on a newsletter.
Part of the Professional plan. One bearer token, 1,000 requests a day.
Two minutes to your first request
Create a key in your dashboard, then send it as a bearer token. That's the whole authentication story.
curl
curl -H "Authorization: Bearer $RANKEQ_KEY" \ "https://rankeq.com/api/v1/rankings?limit=25"
Risk-decompose your own book
requests.post(
"https://rankeq.com/api/v1/risk",
headers={"Authorization": f"Bearer {KEY}"},
json={
"holdings": [
{"ticker": "AAPL", "weight": 60},
{"ticker": "NVDA", "weight": 40},
],
"benchmark": "market",
},
).json()A real response
Live from this week's snapshot — GET /api/v1/rankings?ticker=AAPL. Scores are 0–100, higher is better.
{
"snapshot_date": "2026-07-11",
"rank_scale": "0-100, higher is better",
"count": 1,
"total": 1,
"has_more": false,
"results": [
{
"ticker": "AAPL:USA",
"company_name": "Apple, Inc.",
"sector": "Technology",
"country": "USA",
"rank": 75.37,
"factors": {
"growth": 92.81,
"value": 25.46,
"quality": 99.92,
"size": 4.64,
"robustness": 98.54,
"sentiment": 87.09,
"technical": 62.49
},
"price": 315.32,
"median_dollar_volume": 10000000000
}
]
}Endpoints
Base URL https://rankeq.com/api/v1
/meCheck your key
/rankingsThe weekly ranking of the full universe
rank plus all seven factor categories — growth, value, quality, size, robustness, sentiment, technical — for every scored company.limit1–1000offsetmin_ranksectorticker comma-separateddate historical snapshotPage with offset until has_more is false to walk the whole universe.
/portfoliosThe model portfolios your plan includes
/portfolios/{slug}/holdingsCurrent target weights for one model
/riskThe institutional factor-risk model, on any portfolio
holdings (any tickers and weights you like) or model (one of ours), and get back a Barra/Axioma-style decomposition: total, factor and specific volatility, where the risk actually comes from, factor and sector exposures, top risk contributors — plus tracking error and active exposures when you pass a benchmark, and historical stress replays with stress: true.This is the same engine behind the Portfolio Risk page — it will price a portfolio that has nothing to do with RankEq.
Keys, limits, and what happens when things go wrong
Keys are shown to you exactly once, when you create them. We store only a hash — which means if you lose a key we genuinely can't recover it for you, and equally, nobody who breaches our database walks away with working credentials. Revoke a key and it stops working on the very next request. You can hold up to five at a time, so a laptop, a server and a notebook can each have their own.
The limit is 1,000 requests per key per day. Every response tells you where you stand via X-RateLimit-Remaining and X-RateLimit-Reset, and if you do hit the ceiling you get a 429 with a Retry-After rather than a mystery. The full universe is 6,158 names, so a complete weekly pull costs you seven requests.
Rankings refresh once a week. There's no value in polling this thing every minute, and we'd rather tell you that than sell you a bigger quota.
Build on our rankings
API access is part of the Professional plan, alongside a model built around your own mandate.
See plansData is provided for informational purposes only. It is not investment advice, not a recommendation to buy or sell any security, and not personalized to your circumstances. Rankings are quantitative model output and may contain errors or omissions.