SimplyWallSt — Stock Research & Snowflake Scores
SimplyWallSt — Stock Research & Snowflake Scores
Extrae datos financieros de
SimplyWallSt usando su
API REST interna (
). 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.
使用SimplyWallSt的
内部REST API（
）提取财务数据。无需Cloudflare、无需API密钥、无需注册。
涵盖120,000+全球股票，包含Snowflake评分（价值、收益、健康、过往表现、未来潜力、管理层）、估值分析、历史及预测股息、财务健康评分、内部交易等更多数据。
- 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).
- SimplyWallSt 没有官方公开API。本工具使用网页前端的内部接口。
- 请遵守网站的服务条款。
- 请实现请求速率限制（请求间隔至少300毫秒）。
| Script | Descripción |
|---|
| fetch_sws.py | Cliente completo: listar tickers, company detail, snowflake scores, análisis |
| 脚本 | 描述 |
|---|
| fetch_sws.py | 完整客户端：列出股票代码、公司详情、Snowflake评分、分析数据 |
PRIMERO: Descargar snapshot de tickers (1 vez sola, ~5 min)
第一步：下载股票代码快照（仅需一次，约5分钟）
python scripts/fetch_sws.py --download-snapshot
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
python scripts/fetch_sws.py --ticker GGAL
python scripts/fetch_sws.py --search "Galicia"
python scripts/fetch_sws.py --search "Galicia"
Full data con todos los includes (info, score, analysis, extended, raw_data, insider)
获取包含所有附加数据的完整信息（info、score、analysis、extended、raw_data、insider）
python scripts/fetch_sws.py --ticker GGAL --full
python scripts/fetch_sws.py --ticker GGAL --full
Listar empresas (grid)
列出公司（网格视图）
python scripts/fetch_sws.py --grid --size 10
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
python scripts/fetch_sws.py --list-tickers --country AR --output tickers_ar.csv
Snowflake scores de múltiples tickers
获取多个股票代码的Snowflake评分
python scripts/fetch_sws.py --ticker GGAL,BMA,SUPV --score
python scripts/fetch_sws.py --ticker GGAL,BMA,SUPV --score
python scripts/fetch_sws.py --ticker GGAL --full --output ggal_data.json
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 |
| 接口 | 请求方法 | 返回数据 | 状态 |
|---|
/api/grid/filter?include=info,score,grid
| POST | 包含评分和指标的公司列表 | ✅ 可用 |
/api/company{canonical_url}
| GET | 公司完整详情 | ✅ 可用 |
Includes disponibles para Company Detail
公司详情可用的附加数据项
| Include | Data |
|---|
| Perfil corporativo, industria, país, empleados, CEO |
| Snowflake scores (value, income, health, past, future, management) |
| Precio, market cap, P/E, P/B, ROE, ROA, EPS, dividendos, growth |
| Dividendos históricos, payout ratio, buyback, future EPS |
analysis.extended.raw_data
| Financial statements históricos |
analysis.extended.raw_data.insider_transactions
| Insider trading |
| 附加项 | 返回数据 |
|---|
| 公司简介、行业、国家、员工数、CEO |
| Snowflake评分（价值、收益、健康、过往表现、未来潜力、管理层） |
| 股价、市值、市盈率（P/E）、市净率（P/B）、净资产收益率（ROE）、资产收益率（ROA）、每股收益（EPS）、股息、增长数据 |
| 历史股息、派息率、股票回购、未来每股收益 |
analysis.extended.raw_data
| 历史财务报表 |
analysis.extended.raw_data.insider_transactions
| 内部交易数据 |
| 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 |
| 特性 | 详情 |
|---|
| 全球股票 | 覆盖90+市场的120,000+只股票 |
| 阿根廷市场 | ✅ BASE（布宜诺斯艾利斯证券交易所）股票代码：GGAL、BMA、SUPV、YPFD等 |
| 美国市场 | ✅ NasdaqGS、NYSE、AMEX |
| 更新频率 | 每日更新（收盘价） |
| Snowflake评分 | 价值、收益、健康、过往表现、未来潜力、管理层 |
| 股息 | 19+年历史数据、未来预测 |
| 内部交易 | ✅（数据可用时） |
| 分析师数据 | 共识数量及目标价 |
| Flag | Descripción |
|---|
| Ticker(s) separados por coma: GGAL o GGAL,BMA |
| Buscar por nombre |
| Todos los includes disponibles |
| Solo snowflake scores |
| Solo info corporativa |
| Solo métricas de análisis |
| Incluir data extendida |
| Incluir raw data financiera |
| Listar companies via grid/filter |
| Listar tickers disponibles |
| Filtrar por país (solo --grid) |
| Tamaño de página (default: 24) |
| Límite de resultados |
| Descargar snapshot completo de tickers a |
| Usar snapshot específico (default: auto-buscar en ) |
| Guardar output |
| Output en CSV |
| Delay entre requests (default: 0.3s) |
| 参数 | 描述 |
|---|
| 逗号分隔的股票代码：GGAL 或 GGAL,BMA |
| 通过名称搜索 |
| 获取所有可用的附加数据 |
| 仅获取Snowflake评分 |
| 仅获取公司信息 |
| 仅获取分析指标 |
| 包含扩展数据 |
| 包含原始财务数据 |
| 通过grid/filter列出公司 |
| 列出可用股票代码 |
| 按国家筛选（仅适用于--grid） |
| 每页大小（默认：24） |
| 结果数量限制 |
| 下载完整股票代码快照到目录 |
| 使用指定的快照文件（默认：自动在目录查找） |
| 保存输出结果 |
| 以CSV格式输出 |
| 请求间隔时间（默认：0.3秒） |
Ejemplos por tipo de data
各类数据示例
Snowflake Scores
Snowflake评分
bash
python scripts/fetch_sws.py --ticker GGAL --score
bash
python scripts/fetch_sws.py --ticker GGAL --score
→ value=0, income=0, health=4, past=1, future=5, management=0
→ value=0, income=0, health=4, past=1, future=5, management=0
→ "High growth potential with adequate balance sheet."
→ "High growth potential with adequate balance sheet."
bash
python scripts/fetch_sws.py --ticker GGAL --info
bash
python scripts/fetch_sws.py --ticker GGAL --info
→ name, industry (Banks), country (AR), employees (10032), year_founded (1905)
→ 名称、行业（银行）、国家（阿根廷）、员工数（10032）、成立年份（1905）
Análisis + Dividendos
分析数据 + 股息
bash
python scripts/fetch_sws.py --ticker GGAL --analysis --extended
bash
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
→ 股息历史、派息率、未来收益率
bash
python scripts/fetch_sws.py --ticker GGAL --full
bash
python scripts/fetch_sws.py --ticker GGAL --full
Trabajar con el grid/filter
使用grid/filter功能
El grid/filter devuelve companies listas para consumir con info + scores + grid metrics en un solo request. Ideal para screener:
grid/filter返回可直接使用的公司列表，包含信息+评分+网格指标，一次请求即可获取。非常适合筛选器场景：
Todas las empresas (default: market cap desc)
所有公司（默认：按市值降序）
python scripts/fetch_sws.py --grid --limit 50
python scripts/fetch_sws.py --grid --limit 50
Top 10 Argentina
阿根廷Top 10公司
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.
---
python scripts/fetch_sws.py --grid --size 10
> **注意：** grid/filter不支持直接按国家或股票代码筛选。请使用`--list-tickers` + `--country`在客户端进行筛选。
---
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.
股票代码快照是本地CSV文件，包含所有可用上市股票信息，可实现即时解析股票代码，无需遍历grid。
Descargar el snapshot (1 vez, ~10 min)
下载快照（仅需一次，约10分钟）
Descarga completa (~10 min, genera assets/YY-MM-DD-ticker-snapshot.csv)
完整下载（约10分钟，生成assets/YY-MM-DD-ticker-snapshot.csv）
python scripts/fetch_sws.py --download-snapshot
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:
- Fase 1: Obtiene top 10K con la query default → extrae los exchanges disponibles
- Fase 2: Para cada exchange, fetchea todas las empresas (cada exchange tiene < 10K registros)
- Dedup: Combina todo y elimina duplicados por (exchange + ticker)
API每个查询有10,000条记录的限制。为获取全部数据，脚本采用按交易所分区的方式：
- 阶段1：使用默认查询获取前10,000条记录 → 提取可用交易所
- 阶段2：针对每个交易所，获取所有公司（每个交易所的记录数<10,000）
- 去重：合并所有数据并按（交易所+股票代码）去除重复项
| Métrica | Valor |
|---|
| Total listings únicos () | 78,454 |
| Países cubiertos | 83 |
| Exchanges | 106 |
| Duplicados en el proceso de dedup | 0 |
| Requests totales | ~944 |
| Duración | ~11 min |
| Tamaño del CSV | ~6 MB |
¿Por qué 78K y no 54K? El API reporta
para la query default (que filtra por scores mínimos). Pero al particionar por exchange con reglas más simples (
+
), se obtienen
muchos más — ETFs, fondos, companies sin scores, y ADRs. Las 54K son solo las que cumplen los filtros default.
| 指标 | 数值 |
|---|
| 唯一上市股票总数（） | 78,454 |
| 覆盖国家 | 83 |
| 交易所数量 | 106 |
| 去重过程中的重复项 | 0 |
| 总请求数 | ~944 |
| 耗时 | ~11分钟 |
| CSV文件大小 | ~6 MB |
为什么是78K而不是54K？ 默认查询（按最低评分筛选）的API报告
。但通过更简单的规则按交易所分区（
+
），可以获取
更多数据——包括ETF、基金、无评分公司和ADR。54K只是符合默认筛选条件的股票数量。
Verificación de calidad de datos
数据质量验证
| Control | Resultado |
|---|
| duplicados | 0 — dedup 100% efectivo |
| Mismo ticker + mismo exchange repetido | 3 casos — todos son falsos positivos (leading zeros: ≠ ) |
| Tickers cross-listed (múltiples exchanges) | 8,751 — legítimo, una empresa listada en varios mercados |
| Países con más listings | US (16,274), CN (7,016), IN (6,074), CA (5,221), JP (4,764) |
| 检查项 | 结果 |
|---|
| 重复项 | 0 — 去重100%有效 |
| 同一股票代码+同一交易所重复 | 3例 — 均为误判（前导零差异： ≠ ） |
| 交叉上市股票（多交易所） | 8,751 — 合法，同一公司在多个市场上市 |
| 上市股票最多的国家 | 美国（16,274）、中国（7,016）、印度（6,074）、加拿大（5,221）、日本（4,764） |
Sin snapshot,
tarda ~30s iterando el grid. Con snapshot, es instantáneo.
不使用快照时，
需耗时约30秒遍历grid。使用快照则可即时响应。
| Campo | Descripción |
|---|
| Símbolo (GGAL, BMA, MSFT, etc.) |
| Nombre de la empresa |
| Exchange (BASE, NasdaqGS, NYSE) |
| Ruta API para company detail |
| Exchange + Ticker (clave única) |
| Código ISO país |
| Industria |
| N° empleados |
| Año fundación |
score_value/income/health/past/future/management/total
| Snowflake scores |
| Precio actual |
| Market cap (moneda local) |
| , | Múltiplos |
| 字段 | 描述 |
|---|
| 股票代码（GGAL、BMA、MSFT等） |
| 公司名称 |
| 交易所（BASE、NasdaqGS、NYSE） |
| 公司详情API路径 |
| 交易所+股票代码（唯一标识） |
| ISO国家代码 |
| 行业 |
| 员工数量 |
| 成立年份 |
score_value/income/health/past/future/management/total
| Snowflake评分 |
| 当前股价 |
| 市值（当地货币） |
| , | 估值倍数 |
Snapshot específico
使用指定快照
bash
python scripts/fetch_sws.py --snapshot assets/26-06-04-ticker-snapshot.csv --ticker GGAL
bash
python scripts/fetch_sws.py --snapshot assets/26-06-04-ticker-snapshot.csv --ticker GGAL
Mapa Exchange → País
交易所→国家映射
| Exchange | País | Listings | Descripción |
|---|
| US | 6,138 | OTC Markets Pink (EEUU) |
| JP | 4,693 | Tokyo Stock Exchange (Japón) |
| IN | 3,833 | BSE India (antes Bombay SE) |
| CN | 3,723 | Shenzhen Stock Exchange (China) |
| CN | 3,293 | Shanghai Stock Exchange (China) |
| HK | 3,019 | Hong Kong Exchange |
| US | 2,574 | New York Stock Exchange |
| AU | 2,527 | Australian Securities Exchange |
| CA | 2,381 | Toronto Stock Exchange (Canadá) |
| US | 2,304 | NASDAQ Global Market |
| IN | 2,241 | National Stock Exchange of India |
| KR | 2,075 | Korea Exchange (KOSPI) |
| CA | 1,999 | TSX Venture Exchange (Canadá) |
| KR | 1,997 | KOSDAQ (Corea) |
| GB | 1,963 | London Stock Exchange |
| US | 1,854 | NASDAQ Capital Market |
| US | 1,575 | BATS Exchange (EEUU) |
| US | 1,532 | NASDAQ Global Select |
| ES | 1,514 | Bolsas y Mercados Españoles |
| TW | 1,430 | Taipei Exchange (Taiwán) |
| GB | 1,310 | AIM (London Stock Exchange) |
| TW | 1,292 | Taiwan Stock Exchange |
| MY | 1,172 | Bursa Malaysia |
| FR | 1,147 | Euronext Paris |
| DE | 1,135 | Xetra (Deutsche Börse) |
| BR | 1,120 | B3 (Brasil) |
| IL | 1,029 | Tel Aviv Stock Exchange |
| TH | 993 | Stock Exchange of Thailand |
| ID | 985 | Indonesia Stock Exchange |
| SE | 852 | OMX Nordic (Estocolmo) |
| PL | 849 | Warsaw Stock Exchange |
| NO | 811 | Oslo Børs (Noruega) |
| CA | 777 | Canadian Securities Exchange |
| ZA | 754 | Johannesburg Stock Exchange |
| DE | 648 | Deutsche Börse (Frankfurt) |
| CL | 647 | Santiago Stock Exchange (Chile) |
| DK | 636 | Copenhagen Stock Exchange |
| IT | 625 | Borsa Italiana |
| CH | 588 | SIX Swiss Exchange |
| IE | 577 | Irish Stock Exchange |
| VN | 572 | Ho Chi Minh Stock Exchange |
| VN | 417 | Hanoi Stock Exchange |
| SG | 398 | Singapore Exchange |
| BD | 443 | Dhaka Stock Exchange |
| AE | 70 | Dubai Financial Market |
| AE | 85 | Abu Dhabi Securities Exchange |
| AR | 84 | Bolsa de Buenos Aires (Argentina) |
| MX | 147 | Bolsa Mexicana de Valores |
| PE | 102 | Bolsa de Valores de Lima (Perú) |
| CO | 56 | Bolsa de Valores de Colombia |
| ... | ... | ... | 106 exchanges en total |
El mapping completo de los 106 exchanges está en references/REFERENCE.md.
| 交易所 | 国家 | 上市数量 | 描述 |
|---|
| 美国 | 6,138 | OTC Markets Pink（美国） |
| 日本 | 4,693 | 东京证券交易所（日本） |
| 印度 | 3,833 | 印度孟买证券交易所 |
| 中国 | 3,723 | 深圳证券交易所（中国） |
| 中国 | 3,293 | 上海证券交易所（中国） |
| 中国香港 | 3,019 | 香港交易所 |
| 美国 | 2,574 | 纽约证券交易所 |
| 澳大利亚 | 2,527 | 澳大利亚证券交易所 |
| 加拿大 | 2,381 | 多伦多证券交易所（加拿大） |
| 美国 | 2,304 | NASDAQ全球市场 |
| 印度 | 2,241 | 印度国家证券交易所 |
| 韩国 | 2,075 | 韩国交易所（KOSPI） |
| 加拿大 | 1,999 | TSX风险交易所（加拿大） |
| 韩国 | 1,997 | KOSDAQ（韩国） |
| 英国 | 1,963 | 伦敦证券交易所 |
| 美国 | 1,854 | NASDAQ资本市场 |
| 美国 | 1,575 | BATS交易所（美国） |
| 美国 | 1,532 | NASDAQ全球精选市场 |
| 西班牙 | 1,514 | 西班牙证券市场 |
| 中国台湾 | 1,430 | 台湾证券柜台买卖中心 |
| 英国 | 1,310 | AIM（伦敦证券交易所） |
| 中国台湾 | 1,292 | 台湾证券交易所 |
| 马来西亚 | 1,172 | 马来西亚交易所 |
| 法国 | 1,147 | 泛欧交易所巴黎 |
| 德国 | 1,135 | Xetra（德意志交易所） |
| 巴西 | 1,120 | B3（巴西） |
| 以色列 | 1,029 | 特拉维夫证券交易所 |
| 泰国 | 993 | 泰国证券交易所 |
| 印度尼西亚 | 985 | 印度尼西亚证券交易所 |
| 瑞典 | 852 | OMX北欧交易所（斯德哥尔摩） |
| 波兰 | 849 | 华沙证券交易所 |
| 挪威 | 811 | 奥斯陆证券交易所（挪威） |
| 加拿大 | 777 | 加拿大证券交易所 |
| 南非 | 754 | 约翰内斯堡证券交易所 |
| 德国 | 648 | 德意志交易所（法兰克福） |
| 智利 | 647 | 圣地亚哥证券交易所（智利） |
| 丹麦 | 636 | 哥本哈根证券交易所 |
| 意大利 | 625 | 意大利证券交易所 |
| 瑞士 | 588 | SIX瑞士交易所 |
| 爱尔兰 | 577 | 爱尔兰证券交易所 |
| 越南 | 572 | 胡志明市证券交易所 |
| 越南 | 417 | 河内证券交易所 |
| 新加坡 | 398 | 新加坡交易所 |
| 孟加拉国 | 443 | 达卡证券交易所 |
| 阿联酋 | 70 | 迪拜金融市场 |
| 阿联酋 | 85 | 阿布扎比证券交易所 |
| 阿根廷 | 84 | 布宜诺斯艾利斯证券交易所（阿根廷） |
| 墨西哥 | 147 | 墨西哥证券交易所 |
| 秘鲁 | 102 | 利马证券交易所（秘鲁） |
| 哥伦比亚 | 56 | 哥伦比亚证券交易所 |
| ... | ... | ... | 共106个交易所 |
完整的106个交易所映射请查看references/REFERENCE.md。
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 para la documentación exhaustiva con ejemplos de respuesta, campos, y consideraciones técnicas.
skills/simplywallst/
├── SKILL.md # 本文件
├── references/
│ └── REFERENCE.md # 接口和数据完整文档
├── scripts/
│ └── fetch_sws.py # 主脚本
└── assets/
└── YY-MM-DD-ticker-snapshot.csv # 生成的股票代码快照
📖 详细文档： 请查看references/REFERENCE.md获取包含响应示例、字段说明和技术注意事项的完整文档。