nasdaq-data

Nasdaq — 内部 API による市場データ

Nasdaq.com のデータを、内部 REST API を使って取得するスキルです。API キーも認証も不要で、厳しいレート制限もありません。

---

⚠️ 法的な注意事項

• Nasdaq には無料の公式公開 APIはありません。これらのエンドポイントは内部向けであり、予告なく変更される場合があります。
• レート制限を実装してください（リクエスト間隔は最低 0.3 秒）。
• サイトの利用規約を遵守してください。

---

インストール

スクリプトは 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	その株式が上位 10 銘柄に含まれる ETF	REST API	/api/company/{ticker}/holdings
etf-holdings	ETF の上位 10 保有銘柄	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 エラー／BAN のリスク
0.3s	✅ 安全（--all のデフォルト）
1s+	✅ 複数リクエストに最適

---

API で利用できないエンドポイント

以下のデータには内部 JSON エンドポイントがなく、HTML スクレイピングが必要です。

ページ	状態	代替手段
休場日スケジュール	❌ 内部 API は検出されていません	HTML のみ
ETF 詳細（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

---

詳細なドキュメント： 各エンドポイント、JSON 構造、例、技術的な考慮事項について詳しくは、references/REFERENCE.md を参照してください。