CEORater Skill
Query CEO performance data for S&P 500 and major U.S. public companies via the CEORater API.
Prerequisites
- 1. Get an API key at https://www.ceorater.com/api-docs.html ($99/month per user)
- Set the environment variable: INLINECODE0
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
CODEBLOCK0
Search CEOs
CODEBLOCK1
List All CEOs
CODEBLOCK2
Get Metadata (live record count + last refresh timestamp)
CODEBLOCK3
Usage Instructions
When the user asks about CEO performance, ratings, or executive compensation:
- 1. Single CEO lookup: Use the
/v1/ceo/{ticker} endpoint - Sector/industry analysis: Use INLINECODE2
- Bulk data: Use INLINECODE3
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)
CODEBLOCK4
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:
CODEBLOCK5
Data Coverage
- - 500+ CEOs, including S&P 500 constituents
- Live record count and refresh timestamp are available via INLINECODE7
- 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
CEORater 技能
通过 CEORater API 查询标普500及美国主要上市公司的CEO绩效数据。
前提条件
- 1. 在 https://www.ceorater.com/api-docs.html 获取API密钥（每位用户每月99美元）
- 设置环境变量：CEORATERAPIKEY=zpkayourkey_here
许可说明： 自助API访问仅允许个人研究分析。将CEORater数据整合到专有公司模型、AI/机器学习训练或构建产品中需要签订企业协议——请联系 sales@ceorater.com。
可用指标
| 指标 | 范围 | 描述 |
|---|
| CEORater评分 | 0-100 | 综合CEO效能评级 |
| Alpha评分 |
0-100 | 相对市场基准的表现 |
| 收入CAGR评分 | 0-100 | 任期调整后的收入增长百分位 |
| 薪酬评分 | A-F | 薪酬效率等级 |
| 任期内TSR | % | CEO任期内的总股东回报 |
| TSR vs. 标普500 | % | 相对标普500（SPY）的表现 |
| CEO薪酬 | 百万美元 | 最近一次代理声明中的总薪酬 |
| 收入CAGR | % | 任期调整后的复合年收入增长率 |
API端点
按股票代码获取CEO
bash
curl -H Authorization: Bearer $CEORATER
APIKEY \
https://api.ceorater.com/v1/ceo/AAPL?format=raw
搜索CEO
bash
curl -H Authorization: Bearer $CEORATER
APIKEY \
https://api.ceorater.com/v1/search?q=technology&format=raw
列出所有CEO
bash
curl -H Authorization: Bearer $CEORATER
APIKEY \
https://api.ceorater.com/v1/ceos?limit=100&format=raw
获取元数据（实时记录数+最后刷新时间戳）
bash
curl -H Authorization: Bearer $CEORATER
APIKEY \
https://api.ceorater.com/v1/meta
使用说明
当用户询问CEO表现、评级或高管薪酬时：
- 1. 单个CEO查询： 使用 /v1/ceo/{ticker} 端点
- 行业/领域分析： 使用 /v1/search?q={query}
- 批量数据： 使用 /v1/ceos?limit=N
始终使用 format=raw 获取适合计算的数值。
示例查询
- - 蒂姆·库克的CEORater评分是多少？ → GET /v1/ceo/AAPL
- 显示科技行业的CEO → GET /v1/search?q=technology
- 评分最高的CEO有哪些？ → GET /v1/ceos，按ceoraterScore排序
- 比较蒂姆·库克和萨提亚·纳德拉 → GET /v1/ceo/AAPL 和 /v1/ceo/MSFT
响应格式（原始）
json
{
companyName: 苹果公司,
ticker: AAPL,
sector: 科技,
industry: 计算机制造,
ceo: 蒂姆·库克,
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
}
错误处理
未找到股票代码 |
| 400 | 请求参数错误（例如搜索时缺少q参数） |
| 429 | 请求频率受限，请退避重试 |
辅助脚本
为方便使用，请使用 {baseDir}/scripts/ceorater.sh：
bash
获取单个CEO
{baseDir}/scripts/ceorater.sh get AAPL
搜索
{baseDir}/scripts/ceorater.sh search healthcare
列出前N个
{baseDir}/scripts/ceorater.sh list 20
数据覆盖范围
- - 500+位CEO，包括标普500成分股公司
- 实时记录数和刷新时间戳可通过 GET /v1/meta 获取
- 工作日在美股收盘后每日更新
- 响应结果可安全缓存最多24小时
更多信息
- - 文档：https://www.ceorater.com/api-docs.html
- Agent清单：https://www.ceorater.com/.well-known/agent.json
- 支持：support@ceorater.com
- 企业销售：sales@ceorater.com
