--- name: nasdaq-data description: "Scraper de datos de Nasdaq.com via API REST interna: cotizaciones, short interest, financials, institutional holdings, opciones, noticias. Sin API key." license: MIT --- # Nasdaq — Datos de Mercado via API Interna Skill para extraer datos de [Nasdaq.com](https://www.nasdaq.com/market-activity/stocks) usando sus **APIs REST internas** — sin API key, sin autenticacion, sin rate limiting agresivo. --- ## ⚠️ Aviso Legal - Nasdaq **no tiene API publica oficial** gratuita. Estos endpoints son **internos** y pueden cambiar sin aviso. - Implementar **rate limiting** (minimo 0.3s entre requests). - Respetar los **terminos de servicio** del sitio. --- ## Instalacion El script usa `requests` (ya disponible en el entorno). --- ## Scripts | Script | Descripcion | |--------|-------------| | **[fetch_nasdaq.py](./scripts/fetch_nasdaq.py)** | Script principal: todos los endpoints disponibles | --- ## Uso rapido ```bash # Informacion de la empresa + precio python scripts/fetch_nasdaq.py info NVDA python scripts/fetch_nasdaq.py info GGAL # Short interest historico python scripts/fetch_nasdaq.py short-interest GGAL # Chart OHLCV (ultimo año por defecto) python scripts/fetch_nasdaq.py chart NVDA python scripts/fetch_nasdaq.py chart NVDA --from 2025-01-01 --to 2026-06-04 # Estados financieros (Income Statement, Balance Sheet, Cash Flow, Ratios) python scripts/fetch_nasdaq.py financials NVDA # Institutional holdings (13F) python scripts/fetch_nasdaq.py institutional-holdings NVDA # ETFs donde el stock es Top 10 Holding python scripts/fetch_nasdaq.py holdings NVDA python scripts/fetch_nasdaq.py holdings GGAL # Top 10 Holdings de un ETF python scripts/fetch_nasdaq.py etf-holdings SPY python scripts/fetch_nasdaq.py etf-holdings QQQ # Perfil de la empresa python scripts/fetch_nasdaq.py company-profile AAPL # Dividendos python scripts/fetch_nasdaq.py dividends NVDA python scripts/fetch_nasdaq.py eps NVDA # EPS histórico + upcoming # Insider trading python scripts/fetch_nasdaq.py insider-trades NVDA # Summary 3/12m + transacciones python scripts/fetch_nasdaq.py insider-trades NVDA --type buy python scripts/fetch_nasdaq.py insider-trades NVDA --type sell python scripts/fetch_nasdaq.py insider-trades NVDA --limit 20 # Opciones python scripts/fetch_nasdaq.py option-chain NVDA # Ultimas noticias python scripts/fetch_nasdaq.py news NVDA --limit 5 # Screener de acciones python scripts/fetch_nasdaq.py screener --exchange nasdaq --limit 10 # Screener de ETFs (4551 ETFs listados) python scripts/fetch_nasdaq.py screener-etf --limit 5 # Calendarios globales python scripts/fetch_nasdaq.py ipo-calendar # IPO upcoming (mes actual) python scripts/fetch_nasdaq.py ipo-calendar --type spo # SPO: secondary offerings python scripts/fetch_nasdaq.py ipo-calendar --date 2026-05 # IPOs de Mayo 2026 python scripts/fetch_nasdaq.py ipo-calendar --type spo --date 2026-06 # SPOs de Junio 2026 python scripts/fetch_nasdaq.py earnings-calendar # Earnings hoy python scripts/fetch_nasdaq.py earnings-calendar --date 2026-06-05 # Earnings de una fecha especifica python scripts/fetch_nasdaq.py economic-calendar # Economic calendar (hoy) python scripts/fetch_nasdaq.py economic-calendar --date 2026-06-04 # Economic calendar de una fecha python scripts/fetch_nasdaq.py dividend-calendar # Dividendos hoy python scripts/fetch_nasdaq.py dividend-calendar --date 2026-06-04 # Dividendos de una fecha python scripts/fetch_nasdaq.py splits-calendar # Stock splits # TODO: todos los endpoints en uno python scripts/fetch_nasdaq.py all GGAL python scripts/fetch_nasdaq.py all NVDA -o nvda_all.json # Modo silencioso (solo JSON) python scripts/fetch_nasdaq.py info AAPL -q python scripts/fetch_nasdaq.py all MSFT -o msft.json -q ``` --- ## Endpoints disponibles | Modo | Data | Metodo | Endpoint Interno | |------|------|--------|------------------| | `info` | Cotizacion, precio, key stats | API REST | `/api/quote/{ticker}/info` | | `short-interest` | Short interest historico | API REST | `/api/quote/{ticker}/short-interest` | | `chart` | OHLCV historico | API REST | `/api/quote/{ticker}/chart` | | `financials` | Income Statement, BS, CF, Ratios | API REST | `/api/company/{ticker}/financials` | | `institutional-holdings` | Tenencias institucionales (13F) | API REST | `/api/company/{ticker}/institutional-holdings` | | `holdings` | ETFs donde el stock es Top 10 Holding | API REST | `/api/company/{ticker}/holdings` | | `etf-holdings` | Top 10 Holdings de un ETF | API REST | `/api/company/{ticker}/holdings` | | `company-profile` | Descripcion, sector, direccion | API REST | `/api/company/{ticker}/company-profile` | | `dividends` | Dividendos | API REST | `/api/quote/{ticker}/dividends` | | `eps` | EPS historico + upcoming por ticker | API REST | `/api/quote/{ticker}/eps` | | `insider-trades` | Insider trading: summary 3/12m + transacciones | API REST | `/api/company/{ticker}/insider-trades` | | `option-chain` | Cadena de opciones | API REST | `/api/quote/{ticker}/option-chain` | | `news` | Ultimas noticias | API REST | `/api/news/topic/articlebysymbol` | | `screener` | Screener de acciones | API REST | `/api/screener/stocks` | | `screener-etf` | Screener de ETFs | API REST | `/api/screener/etf` | | `ipo-calendar` | IPO + SPO calendar | API REST | `/api/ipo/calendar` | | `earnings-calendar` | Earnings calendar con EPS | API REST | `/api/calendar/earnings` | | `economic-calendar` | Economic events (actual, consensus, previous) | API REST | `/api/calendar/economicevents` | | `dividend-calendar` | Dividendos (ex-date, pay-date, rate) | API REST | `/api/calendar/dividends` | | `splits-calendar` | Stock splits | API REST | `/api/calendar/splits` | | `all` | Todos los anteriores combinados | - | - | --- ## Flags adicionales | Flag | Descripcion | |------|-------------| | `--from YYYY-MM-DD` | Fecha inicio para chart | | `--to YYYY-MM-DD` | Fecha fin para chart | | `--limit N` | Limite de resultados (news, screener) | | `--offset N` | Offset para paginacion (screener) | | `--exchange X` | Exchange para screener (default: nasdaq) | | `--type ipo\|spo\|all\|buy\|sell` | Tipo: ipo/spo (ipo-calendar) o all/buy/sell (insider-trades) | | `--date YYYY-MM\|DD` | Fecha para calendarios: YYYY-MM (ipo) o YYYY-MM-DD (earnings/dividend) | | `-o archivo.json` | Guardar output a archivo | | `-q` / `--quiet` | Modo silencioso (solo JSON) | --- ## Rate limiting | Delay | Resultado | |-------|-----------| | <0.2s | Riesgo de 429/baneo | | 0.3s | ✅ Seguro (default en `--all`) | | 1s+ | ✅ Ideal para multiples requests | --- ## Endpoints NO disponibles via API Los siguientes datos **no tienen endpoint JSON interno** y requeririan scraping HTML: | Pagina | Estado | Alternativa | |--------|--------|-------------| | Holiday Schedule | ❌ No hay API interna detectada | Solo HTML | | ETF Detail (AUM, fees, desc) | ❌ No hay API interna | Usar `companiesmarketcap --etf TICKER` | --- ## Estructura del skill ``` skills/nasdaq-data/ ├── SKILL.md # Este archivo (guia rapida) ├── references/ │ └── REFERENCE.md # Documentacion completa de todos los endpoints └── scripts/ └── fetch_nasdaq.py # Script principal ``` --- > **Documentacion detallada:** Consultar [references/REFERENCE.md](./references/REFERENCE.md) para la documentacion exhaustiva de cada endpoint, estructuras JSON, ejemplos y consideraciones tecnicas.