/simplywallst

name: simplywallst
description: "Data financiera de 120K+ stocks globales: snowflake scores, valuation, financial health, dividend analysis, insider transactions. Sin API key."
license: MIT

SimplyWallSt — Stock Research & Snowflake Scores

Extrae datos financieros de [SimplyWallSt](https://simplywall.st/) usando su **API REST interna** (`simplywall.st/api/...`). Sin Cloudflare, sin API key, sin registro.

120,000+ stocks globales con **snowflake scores** (value, income, health, past, future, management), análisis de valuación, dividendos históricos y proyectados, score de salud financiera, insider transactions, y más.

---

⚠️ Aviso Legal

• SimplyWallSt **no tiene API pública oficial**. Esta skill usa endpoints internos del frontend web.
• Respetá los **términos de servicio** del sitio.
• Implementá **rate limiting** (mín 300ms entre requests).

---

Instalación

pip install requests

---

Scripts

| Script | Descripción | |--------|-------------| | **[fetch_sws.py](./scripts/fetch_sws.py)** | Cliente completo: listar tickers, company detail, snowflake scores, análisis |

---

Uso rápido

# PRIMERO: Descargar snapshot de tickers (1 vez sola, ~5 min)
python scripts/fetch_sws.py --download-snapshot

# Luego: las búsquedas por ticker usan el snapshot → instantáneas
python scripts/fetch_sws.py --ticker GGAL

# Buscar por nombre
python scripts/fetch_sws.py --search "Galicia"

# Full data con todos los includes (info, score, analysis, extended, raw_data, insider)
python scripts/fetch_sws.py --ticker GGAL --full

# Listar empresas (grid)
python scripts/fetch_sws.py --grid --size 10

# Listar solo tickers disponibles (Argentina)
python scripts/fetch_sws.py --list-tickers --country AR --output tickers_ar.csv

# Snowflake scores de múltiples tickers
python scripts/fetch_sws.py --ticker GGAL,BMA,SUPV --score

# Output a archivo
python scripts/fetch_sws.py --ticker GGAL --full --output ggal_data.json

---

Endpoints descubiertos

| Endpoint | Método | Data | Status | |----------|--------|------|--------| | `/api/grid/filter?include=info,score,grid` | POST | Listado de empresas con scores y métricas | ✅ Funciona | | `/api/company{canonical_url}` | GET | Detail completo de una empresa | ✅ Funciona |

Includes disponibles para Company Detail

| Include | Data | |---------|------| | `info` | Perfil corporativo, industria, país, empleados, CEO | | `score` | Snowflake scores (value, income, health, past, future, management) | | `analysis` | Precio, market cap, P/E, P/B, ROE, ROA, EPS, dividendos, growth | | `analysis.extended` | Dividendos históricos, payout ratio, buyback, future EPS | | `analysis.extended.raw_data` | Financial statements históricos | | `analysis.extended.raw_data.insider_transactions` | Insider trading |

---

Cobertura

| Característica | Detalle | |----------------|---------| | Stocks globales | 120,000+ en 90+ mercados | | Mercados Argentina | ✅ BASE (BCBA) tickers: GGAL, BMA, SUPV, YPFD, etc. | | Mercados US | ✅ NasdaqGS, NYSE, AMEX | | Actualización | Diaria (precio de cierre) | | Snowflake scores | Value, Income, Health, Past, Future, Management | | Dividendos | Histórico 19+ años, proyecciones futuras | | Insider transactions | ✅ (cuando están disponibles) | | Analistas | Consensus count y price targets |

---

Flags del script

| Flag | Descripción | |------|-------------| | `--ticker TICKER` | Ticker(s) separados por coma: GGAL o GGAL,BMA | | `--search QUERY` | Buscar por nombre | | `--full` | Todos los includes disponibles | | `--score` | Solo snowflake scores | | `--info` | Solo info corporativa | | `--analysis` | Solo métricas de análisis | | `--extended` | Incluir data extendida | | `--raw-data` | Incluir raw data financiera | | `--grid` | Listar companies via grid/filter | | `--list-tickers` | Listar tickers disponibles | | `--country AR` | Filtrar por país (solo --grid) | | `--size N` | Tamaño de página (default: 24) | | `--limit N` | Límite de resultados | | `--download-snapshot` | Descargar snapshot completo de tickers a `assets/` | | `--snapshot PATH` | Usar snapshot específico (default: auto-buscar en `assets/`) | | `--output archivo.json` | Guardar output | | `--csv` | Output en CSV | | `--delay N` | Delay entre requests (default: 0.3s) |

---

Ejemplos por tipo de data

Snowflake Scores

python scripts/fetch_sws.py --ticker GGAL --score
# → value=0, income=0, health=4, past=1, future=5, management=0
# → "High growth potential with adequate balance sheet."

Info Corporativa

python scripts/fetch_sws.py --ticker GGAL --info
# → name, industry (Banks), country (AR), employees (10032), year_founded (1905)

Análisis + Dividendos

python scripts/fetch_sws.py --ticker GGAL --analysis --extended
# → P/E, P/B, ROE, ROA, EPS, Debt/Equity, market cap
# → dividend history, payout ratios, future yield

Todos los datos

python scripts/fetch_sws.py --ticker GGAL --full

---

Trabajar con el grid/filter

El grid/filter devuelve **companies listas para consumir** con info + scores + grid metrics en un solo request. Ideal para screener:

# Todas las empresas (default: market cap desc)
python scripts/fetch_sws.py --grid --limit 50

# Top 10 Argentina
python scripts/fetch_sws.py --grid --size 10

> **Nota:** El grid/filter no permite filtros por país o ticker directamente. Usar `--list-tickers` + `--country` para filtrar client-side.

---

Snapshot de tickers (recomendado)

El snapshot es un archivo CSV local con **todos los listings disponibles** que permite **resolver tickers al instante** sin iterar el grid.

Descargar el snapshot (1 vez, ~10 min)

# Descarga completa (~10 min, genera assets/YY-MM-DD-ticker-snapshot.csv)
python scripts/fetch_sws.py --download-snapshot

Cómo funciona el snapshot completo

El API tiene un límite de **10,000 registros** por query. Para obtener todos, el script usa **particionado por exchange**