SimplyWallSt — Stock Research & Snowflake Scores

Extrae datos financieros de SimplyWallSt 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

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

Includes disponibles para Company Detail

Cobertura

Flags del script

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:

1. Fase 1: Obtiene top 10K con la query default → extrae los exchanges disponibles
2. Fase 2: Para cada exchange, fetchea todas las empresas (cada exchange tiene < 10K registros)
3. Dedup: Combina todo y elimina duplicados por unique_symbol (exchange + ticker)

Resultados del snapshot 26-06-04

¿Por qué 78K y no 54K? El API reporta totalrecords=54,530 para la query default (que filtra por scores mínimos). Pero al particionar por exchange con reglas más simples (exchangesymbol=X + primary_flag=true), se obtienen muchos más — ETFs, fondos, companies sin scores, y ADRs. Las 54K son solo las que cumplen los filtros default.

Verificación de calidad de datos

Sin snapshot

Sin snapshot, --ticker GGAL tarda ~30s iterando el grid. Con snapshot, es instantáneo.

Formato del snapshot

Snapshot específico

python scripts/fetch_sws.py --snapshot assets/26-06-04-ticker-snapshot.csv --ticker GGAL

Mapa Exchange → País

El mapping completo de los 106 exchanges está en [references/REFERENCE.md](./references/REFERENCE.md#exchange--country-mapping).

Estructura del skill

skills/simplywallst/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa de endpoints y data
├── scripts/
│   └── fetch_sws.py                      # Script principal
└── assets/
    └── YY-MM-DD-ticker-snapshot.csv      # Snapshot de tickers (generado)

📖 Documentación detallada: Consultá [references/REFERENCE.md](./references/REFERENCE.md) para la documentación exhaustiva con ejemplos de respuesta, campos, y consideraciones técnicas.