CEORater
Verified@ceorater-skills
npx machina-cli add skill @ceorater-skills/ceorater --openclawCEORater Skill
Query CEO performance data for S&P 500 and major U.S. public companies via the CEORater API.
Prerequisites
- Get an API key at https://www.ceorater.com/api-docs.html ($99/month per user)
- Set the environment variable:
CEORATER_API_KEY=zpka_your_key_here
Licensing Note: Self-serve API access permits individual research and analysis. Integrating CEORater data into proprietary firm models, AI/ML training, or building products requires an Enterprise Agreement — contact sales@ceorater.com.
Available Metrics
| Metric | Range | Description |
|---|---|---|
| CEORaterScore | 0-100 | Composite CEO effectiveness rating |
| AlphaScore | 0-100 | Performance vs. market benchmark |
| RevenueCAGRScore | 0-100 | Tenure-adjusted revenue growth percentile |
| CompScore | A-F | Compensation efficiency grade |
| TSR During Tenure | % | Total Stock Return during CEO tenure |
| TSR vs. S&P 500 | % | Performance relative to S&P 500 (SPY) |
| CEO Compensation | $M | Total compensation from most recent proxy filing |
| Revenue CAGR | % | Tenure-adjusted compound annual revenue growth |
API Endpoints
Get CEO by Ticker
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/ceo/AAPL?format=raw"
Search CEOs
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/search?q=technology&format=raw"
List All CEOs
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/ceos?limit=100&format=raw"
Get Metadata (live record count + last refresh timestamp)
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/meta"
Usage Instructions
When the user asks about CEO performance, ratings, or executive compensation:
- Single CEO lookup: Use the
/v1/ceo/{ticker}endpoint - Sector/industry analysis: Use
/v1/search?q={query} - Bulk data: Use
/v1/ceos?limit=N
Always use format=raw for numeric values suitable for calculations.
Example Queries
- "What's the CEORaterScore for Tim Cook?" → GET /v1/ceo/AAPL
- "Show me technology sector CEOs" → GET /v1/search?q=technology
- "Who are the top-rated CEOs?" → GET /v1/ceos, sort by ceoraterScore
- "Compare Tim Cook vs Satya Nadella" → GET /v1/ceo/AAPL and /v1/ceo/MSFT
Response Format (raw)
{
"companyName": "Apple Inc.",
"ticker": "AAPL",
"sector": "Technology",
"industry": "Computer Manufacturing",
"ceo": "Tim Cook",
"founderCEO": false,
"ceoraterScore": 87,
"alphaScore": 93.5,
"revenueCagrScore": 75.2,
"revenueCagr": 0.042,
"compScore": "C",
"tsrMultiple": 22.23,
"tenureYears": 14.4,
"avgAnnualTsrRatio": 1.55,
"compPer1PctTsrMM": 0.482,
"tsrVsSpyRatio": 15.64,
"avgAnnualVsSpyRatio": 1.09,
"compensationMM": 74.6
}
Error Handling
| Code | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 404 | Ticker not found |
| 400 | Bad request parameters (for example, missing q on search) |
| 429 | Rate limited, retry with backoff |
Helper Script
For convenience, use {baseDir}/scripts/ceorater.sh:
# Get single CEO
{baseDir}/scripts/ceorater.sh get AAPL
# Search
{baseDir}/scripts/ceorater.sh search "healthcare"
# List top N
{baseDir}/scripts/ceorater.sh list 20
Data Coverage
- 500+ CEOs, including S&P 500 constituents
- Live record count and refresh timestamp are available via
GET /v1/meta - Updated daily on weekdays after U.S. market close
- Safe to cache responses for up to 24 hours
More Information
- Documentation: https://www.ceorater.com/api-docs.html
- Agent manifest: https://www.ceorater.com/.well-known/agent.json
- Support: support@ceorater.com
- Enterprise sales: sales@ceorater.com
Overview
Provides institutional-grade CEO performance analytics for the S&P 500 and major U.S. public companies via the CEORater API. It exposes proprietary scores (CEORaterScore, AlphaScore, RevenueCAGRScore, CompScore) and key metrics such as TSR, TSR vs. S&P 500, CEO compensation, and tenure-adjusted Revenue CAGR. Coverage spans 500+ CEOs with daily updates, making it valuable for investment research, due diligence, and compensation analysis.
How This Skill Works
Authenticate with your CEORATER_API_KEY and call endpoints like /v1/ceo/{ticker}, /v1/search, or /v1/ceos with format=raw to obtain numeric data. Each record includes CEO name, company, ticker, sector, industry, tenure dates, and the four scores plus metrics (TSR, TSR vs SPY, CEO compensation, Revenue CAGR). The data is refreshed daily across 500+ CEOs for up-to-date analysis.
When to Use It
- When researching CEO effectiveness for a stock investment or due diligence.
- When ranking leaders by CEORaterScore or AlphaScore to identify top performers.
- When evaluating compensation efficiency using CompScore against measured performance.
- When benchmarking TSR during tenure and TSR vs S&P 500 to assess market-relative impact.
- When validating data recency by checking live record count and last refresh via metadata.
Quick Start
- Step 1: Get an API key at https://www.ceorater.com and set CEORATER_API_KEY.
- Step 2: Fetch your first record with a ticker, e.g. /v1/ceo/MSFT?format=raw.
- Step 3: Analyze CEORaterScore, AlphaScore, RevenueCAGRScore, and CompScore; export results for reporting.
Best Practices
- Always fetch numeric data with format=raw for calculations.
- Cross-validate CEORater metrics with proxy filings for compensation context.
- Filter by tenure length to compare leaders with similar experience.
- Use the metadata endpoint to confirm live data coverage and recency.
- Combine CEORater scores with TSR-based performance for a holistic view.
Example Use Cases
- Query AAPL’s metrics: GET /v1/ceo/AAPL?format=raw to retrieve Tim Cook’s CEORater data.
- Find top-rated tech CEOs: GET /v1/ceos?limit=100&format=raw and sort by AlphaScore.
- Compare Tim Cook vs Satya Nadella: fetch /v1/ceo/AAPL and /v1/ceo/MSFT and compare scores.
- Assess compensation efficiency across a tech peer group using CompScore.
- Review RevenueCAGRScore changes after a leadership transition to gauge growth momentum.
