# IndexLovers

> Alternative market indices for independent traders. Bringing the alpha to retail IndexLovers.

IndexLovers is an open-methodology financial index platform tracking alternative S&P 100 equity benchmarks with survivorship-bias-free daily EOD time-series and a public JSON REST API.

## Core Documentation & Links
- [Homepage & Index Directory](https://pagina-index-lovers.vercel.app/): Overview of live S&P 100 CEO-based indices (`WSP100` and `MSP100`).
- [Woman SP100 (WSP100) Index Detail](https://pagina-index-lovers.vercel.app/indices/woman-sp100): Equal-weighted S&P 100 companies currently led by a female CEO (`219.74 pts`, Base `100.00` on 2021-01-04).
- [Men SP100 (MSP100) Index Detail](https://pagina-index-lovers.vercel.app/indices/men-sp100): Equal-weighted benchmark of S&P 100 companies currently led by a male CEO (`247.60 pts`, Base `100.00` on 2021-01-04).
- [Interactive Index Comparison Tool](https://pagina-index-lovers.vercel.app/compare): Compare normalized percentage returns (`0.00%` baseline) across `1M`, `6M`, `1Y`, `5Y`, and `MAX` windows.
- [REST API Documentation](https://pagina-index-lovers.vercel.app/docs): Endpoint specifications, cURL/Python snippets, and JSON response schemas.
- [Full LLM Reference (`llms-full.txt`)](https://pagina-index-lovers.vercel.app/llms-full.txt): Complete quantitative methodology, formulas, constituent rules, and FAQ for AI agents.

## Indices Summary

### 1. Woman SP100 (`WSP100`)
- **Slug:** `woman-sp100` (alias `wsp100`)
- **Methodology:** The WSP100 is an equal-weighted index composed of S&P 100 constituent companies currently led by a female Chief Executive Officer. The index is rebalanced quarterly to account for CEO transitions, mergers, and corporate restructuring. Survivorship bias is mitigated by preserving historical constituent data up to the exact date of executive turnover.
- **Latest Level:** `219.74` (`-3.83%` 24h, `+119.74%` since Jan 4, 2021)

### 2. Men SP100 (`MSP100`)
- **Slug:** `men-sp100` (alias `msp100`)
- **Methodology:** The MSP100 serves as the benchmark counterpart, comprising S&P 100 companies led by a male Chief Executive Officer. It follows the identical equal-weighted quarterly rebalancing methodology to provide a direct, clean performance comparison against the WSP100.
- **Latest Level:** `247.60` (`+0.36%` 24h, `+147.60%` since Jan 4, 2021)

## REST API Quickstart
- **Base Endpoint:** `GET https://pagina-index-lovers.vercel.app/api/v1/indices/{slug}?range={1M|6M|1Y|5Y|MAX}`
- **Canonical Endpoint:** `GET https://indexlovers.com/api/v1/indices/{slug}?range={1M|6M|1Y|5Y|MAX}`
- **Response Fields:** `ticker`, `name`, `description`, `methodology`, `currentValue`, `change24h`, `range`, `count`, `historicalData` (`[{ "date": "YYYY-MM-DD", "value": number }]`).