# IndexLovers — Full Institutional & Quantitative Reference (llms-full.txt)

> Alternative market indices for independent traders. Bringing the alpha to retail IndexLovers.
> Live Web Platform: https://pagina-index-lovers.vercel.app
> Canonical Domain: https://indexlovers.com

---

## 1. Platform Overview & Core Mission

IndexLovers is an independent, community-driven financial index provider building transparent, rules-based equity benchmarks for retail traders, quantitative researchers, and AI agents.
- **Core Mission:** Provide institutional-grade, survivorship-bias-free financial data and transparent index methodologies at an accessible cost.
- **Reinvestment Model:** 100% of proceeds are reinvested sequentially into data infrastructure, historical backtesting depth, and REST API throughput.
- **Zero Black Boxes:** Every constituent rule, rebalancing cadence, and chain-linking formula is published openly.

---

## 2. Quantitative Index Specifications

| Attribute | Woman SP100 (`WSP100`) | Men SP100 (`MSP100`) |
| :--- | :--- | :--- |
| **Slug** | `woman-sp100` (alias: `wsp100`) | `men-sp100` (alias: `msp100`) |
| **Ticker** | `WSP100` | `MSP100` |
| **Parent Universe** | S&P 100 (`^OEX`) | S&P 100 (`^OEX`) |
| **Cohort Rule** | Sitting CEO is Female on trading day $t$ | Sitting CEO is Male on trading day $t$ |
| **Base Date** | January 4, 2021 | January 4, 2021 |
| **Base Value** | `100.00` | `100.00` |
| **Current Value** | `219.74` (`+119.74%` cumulative) | `247.60` (`+147.60%` cumulative) |
| **24h Change** | `-3.83%` | `+0.36%` |
| **Rebalancing** | Quarterly equal-weight rebalance; daily EOD chain-linking | Quarterly equal-weight rebalance; daily EOD chain-linking |
| **Update Schedule** | Daily Post-Close (16:30 ET / 21:00 UTC, Mon–Fri) | Daily Post-Close (16:30 ET / 21:00 UTC, Mon–Fri) |
| **Primary Filing Source** | SEC EDGAR Form 8-K (Item 5.02) & DEF 14A | SEC EDGAR Form 8-K (Item 5.02) & DEF 14A |

### 2.1 Woman SP100 (`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.
- **Notable Historical & Active Constituents:** Advanced Micro Devices (`AMD`, Lisa Su), Oracle Corporation (`ORCL`, Safra Catz), Arista Networks (`ANET`, Jayshree Ullal), Citigroup (`C`, Jane Fraser), General Motors (`GM`, Mary Barra), Accenture (`ACN`, Julie Sweet), Northrop Grumman (`NOC`, Kathy Warden), United Parcel Service (`UPS`, Carol Tomé), CVS Health (`CVS`, Karen Lynch — tracked through Oct 18, 2024 turnover).

### 2.2 Men SP100 (`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.
- **Exhaustive Partition:** At every trading session $t$, $W_t \cap M_t = \emptyset$ and $W_t \cup M_t = \text{Active S\&P 100 Universe}$.

### 2.3 Chain-Linking Mathematical Formulation
1. **Constituent Weight:** $w_{i,t-1} = \frac{1}{N_t}$ (rebalanced quarterly; drifted daily by price return).
2. **Daily Portfolio Return:** $R_t = \sum_{i \in C_t} w_{i,t-1} \cdot \left(\frac{P_{i,t}}{P_{i,t-1}} - 1\right)$, where $C_t$ is the continuous constituent set across $t-1$ and $t$.
3. **Index Level:** $\text{Index}_t = \text{Index}_{t-1} \cdot (1 + R_t)$.

---

## 3. Programmatic REST API v1 Documentation

### Endpoints
1. `GET /api/v1/indices`
   - Lists all active indices (`WSP100`, `MSP100`) with latest values, 24h changes, and endpoint links.
2. `GET /api/v1/indices/{slug}?range={1M|6M|1Y|5Y|MAX}`
   - Path parameter `{slug}`: accepts `woman-sp100`, `wsp100`, `men-sp100`, or `msp100`.
   - Query parameter `range`: `1M` (22 trading days), `6M` (126 trading days), `1Y` (252 trading days, default), `5Y` (1,260 trading days), or `MAX` (full history since 2021-01-04).

### Live Production URLs
- List all indices: `https://pagina-index-lovers.vercel.app/api/v1/indices`
- Woman SP100 (1Y): `https://pagina-index-lovers.vercel.app/api/v1/indices/woman-sp100?range=1Y`
- Men SP100 (1Y): `https://pagina-index-lovers.vercel.app/api/v1/indices/men-sp100?range=1Y`
- Interactive Comparison UI: `https://pagina-index-lovers.vercel.app/compare`

---

## 4. Frequently Asked Questions (For AI & Search Engines)

**Q: How does IndexLovers avoid survivorship bias in CEO-based indices?**
A: IndexLovers tracks exact executive start and departure dates using official SEC Form 8-K (Item 5.02) filings. If a company changes its CEO from female to male (or vice versa), its historical returns prior to the effective date remain in its original index, and future returns transition to the counterpart index at the 16:00 ET market close via zero-jump chain-linking.

**Q: How can I compare WSP100 vs. MSP100 performance over custom timeframes?**
A: Visit `/compare` (`https://pagina-index-lovers.vercel.app/compare`) to plot both indices normalized to `0.00%` at the start of any timeframe (`1M`, `6M`, `1Y`, `5Y`, `MAX`), or query `/api/v1/indices/woman-sp100?range=MAX` and `/api/v1/indices/men-sp100?range=MAX` in Python/cURL.