1---2name: 2477-fmp-api-endpoints-1e54f4923description: FMP API Endpoints Used by VCP Screener4---5# FMP API Endpoints Used by VCP Screener67## Endpoints89### 1. S&P 500 Constituents10- **URL:** `GET /api/v3/sp500_constituent`11- **Calls:** 1 (cached)12- **Returns:** `[{symbol, name, sector, subSector}, ...]`13- **Used in:** Phase 1 - Universe definition1415### 2. Batch Quote16- **URL:** `GET /api/v3/quote/{symbols}` (comma-separated, max 5)17- **Calls:** ~101 (503 stocks / 5 per batch)18- **Returns:** `[{symbol, price, yearHigh, yearLow, avgVolume, marketCap, ...}]`19- **Used in:** Phase 1 - Pre-filter2021### 3. Historical Prices22- **URL:** `GET /api/v3/historical-price-full/{symbol}?timeseries=260`23- **Calls:** 1 (SPY) + up to 100 (candidates)24- **Returns:** `{symbol, historical: [{date, open, high, low, close, adjClose, volume}, ...]}`25- **Used in:** Phase 2 - Trend Template, Phase 3 - VCP detection2627## API Budget Summary2829| Phase | Operation | API Calls |30|-------|-----------|-----------|31| 1 | S&P 500 constituents | 1 |32| 1 | Batch quotes (503 / 5) | ~101 |33| 2 | SPY 260-day history | 1 |34| 2 | Candidate histories (max 100) | 100 |35| **Total (default)** | | **~203** |36| **Total (--full-sp500)** | | **~350** |3738## Rate Limits3940- **Free tier:** 250 API calls/day - Default screening fits within this limit41- **Starter tier ($29.99/mo):** 750 calls/day42- **Rate limiting:** 0.3s delay between requests, automatic retry on 42943- **Caching:** In-memory session cache prevents duplicate requests4445## Notes4647- All historical data uses `timeseries=260` parameter (260 trading days = ~1 year)48- Phase 3 (VCP detection, scoring, reporting) requires NO additional API calls49- The `--full-sp500` flag fetches histories for all pre-filter passers (~250 stocks)
tools-only