ceorater 1.0.0

CLI for CEORater — institutional-grade CEO performance analytics

CEORater CLI

Command-line interface for CEORater — institutional-grade CEO performance analytics covering 500+ S&P 500 CEOs.

Install

pip install ceorater

Setup

Get your API key at ceorater.com/api-docs.html, then set the CEORATER_API_KEY environment variable.

PowerShell:

$env:CEORATER_API_KEY="your-api-key"

macOS/Linux:

export CEORATER_API_KEY="your-api-key"

Commands

Run the terminal:

ceorater

The interactive prompt uses slash commands:

Command	Description
/ticker	CEO Analytics by ticker
/list	List CEOs
/status	Dataset freshness and API status
/help	Show command menu
/exit	Quit

Look up a CEO by ticker

ceorater
/NVDA

  NVIDIA (NVDA)
  CEO: Jensen Huang  |  Founder: Yes  |  Tenure: 27.3 yrs
  Sector: Technology  |  Industry: Semiconductors

  Metric                  Value
  CEORaterScore              99
  AlphaScore                100
  RevCAGR Score             100
  CompScore                   A

  TSR Multiple         589,250%
  Avg Annual TSR        21,578%
  TSR vs SPY           588,370%
  Avg Annual vs SPY     21,546%

  Compensation ($M)      $49.9M
  Cost/1% TSR ($M)        $0.0M
  Revenue CAGR            69.3%

List all CEOs (paginated)

ceorater
/list

Check data freshness

ceorater
/status

JSON output for agents and scripts

The standard subcommands remain available for scripts. Data commands support --json for raw, machine-readable output:

ceorater lookup AAPL --json

{
  "companyName": "Apple Inc.",
  "ticker": "AAPL",
  "ceoraterScore": 76.2,
  "alphaScore": 93.9,
  "compScore": "C",
  ...
}

Metrics

Metric	Description
CEORaterScore	Composite CEO effectiveness rating (0-100)
AlphaScore	Market outperformance score (0-100)
RevCAGR Score	Tenure-adjusted revenue growth percentile (0-100)
CompScore	Compensation efficiency grade (A-F)
TSR Multiple	Total Shareholder Return during tenure
Cost/1% TSR	CEO compensation cost per 1% of average annual TSR

Requirements

• Python 3.9+
• CEORater API subscription ($99/month) — subscribe here

License

Proprietary. See terms of service.