nasdaq-data

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 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	Script principal: todos los endpoints disponibles

---

Uso rapido

# 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 para la documentacion exhaustiva de cada endpoint, estructuras JSON, ejemplos y consideraciones tecnicas.