nasdaq-data

Nasdaq — 通过内部 API 获取市场数据

使用 Nasdaq.com 的市场活动页面提取数据的 Skill，通过其内部 REST API 获取数据——无需 API key，无需身份验证，也没有激进的速率限制。

---

⚠️ 法律声明

• Nasdaq 没有免费的官方公开 API。这些端点属于内部端点，可能会在不另行通知的情况下发生变化。
• 请实施速率限制（请求间隔至少为 0.3s）。
• 请遵守网站的服务条款。

---

安装

此脚本使用 requests（环境中已提供）。

---

脚本

脚本	描述
fetch_nasdaq.py	主脚本：包含所有可用端点

---

快速使用

# 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

---

可用端点

模式	数据	方法	内部端点
info	报价、价格、关键统计数据	REST API	/api/quote/{ticker}/info
short-interest	历史卖空数据	REST API	/api/quote/{ticker}/short-interest
chart	历史 OHLCV	REST API	/api/quote/{ticker}/chart
financials	损益表、资产负债表、现金流量表、比率	REST API	/api/company/{ticker}/financials
institutional-holdings	机构持仓（13F）	REST API	/api/company/{ticker}/institutional-holdings
holdings	将该股票列为十大持仓之一的 ETF	REST API	/api/company/{ticker}/holdings
etf-holdings	ETF 的十大持仓	REST API	/api/company/{ticker}/holdings
company-profile	描述、行业、地址	REST API	/api/company/{ticker}/company-profile
dividends	股息	REST API	/api/quote/{ticker}/dividends
eps	历史 EPS 和按代码列出的即将公布的 EPS	REST API	/api/quote/{ticker}/eps
insider-trades	内部人士交易：3/12 个月汇总及交易记录	REST API	/api/company/{ticker}/insider-trades
option-chain	期权链	REST API	/api/quote/{ticker}/option-chain
news	最新新闻	REST API	/api/news/topic/articlebysymbol
screener	股票筛选器	REST API	/api/screener/stocks
screener-etf	ETF 筛选器	REST API	/api/screener/etf
ipo-calendar	IPO + SPO 日历	REST API	/api/ipo/calendar
earnings-calendar	含 EPS 的财报日历	REST API	/api/calendar/earnings
economic-calendar	经济事件（实际值、一致预期、前值）	REST API	/api/calendar/economicevents
dividend-calendar	股息（除息日、支付日、股息率）	REST API	/api/calendar/dividends
splits-calendar	股票拆分	REST API	/api/calendar/splits
all	合并以上所有模式	-	-

---

其他标志

标志	描述
--from YYYY-MM-DD	图表的开始日期
--to YYYY-MM-DD	图表的结束日期
--limit N	结果数量上限（新闻、筛选器）
--offset N	分页偏移量（筛选器）
--exchange X	筛选器使用的交易所（默认：nasdaq）
--type ipo|spo|all|buy|sell	类型：ipo/spo（ipo-calendar）或 all/buy/sell（insider-trades）
--date YYYY-MM|DD	日历日期：YYYY-MM（ipo）或 YYYY-MM-DD（earnings/dividend）
-o archivo.json	将输出保存到文件
-q / --quiet	静默模式（仅 JSON）

---

速率限制

延迟	结果
<0.2s	有被限流（429）或封禁的风险
0.3s	✅ 安全（--all 的默认值）
1s+	✅ 多次请求时的理想间隔

---

API 不提供的端点

以下数据没有内部 JSON 端点，需要通过 HTML 抓取：

页面	状态	替代方案
Holiday Schedule	❌ 未检测到内部 API	仅 HTML
ETF Detail（AUM、费用、描述）	❌ 没有内部 API	使用 companiesmarketcap --etf TICKER

---

技能结构

skills/nasdaq-data/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa de todos los endpoints
└── scripts/
    └── fetch_nasdaq.py               # Script principal

---

详细文档： 请参阅 references/REFERENCE.md，了解每个端点的详细文档、JSON 结构、示例和技术注意事项。