simplywallst

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SimplyWallSt — Stock Research & Snowflake Scores

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.

使用SimplyWallSt的内部REST API
simplywall.st/api/...
)提取财务数据。无需Cloudflare、无需API密钥、无需注册。
涵盖120,000+全球股票,包含Snowflake评分(价值、收益、健康、过往表现、未来潜力、管理层)、估值分析、历史及预测股息、财务健康评分、内部交易等更多数据。

⚠️ 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).

  • SimplyWallSt 没有官方公开API。本工具使用网页前端的内部接口。
  • 请遵守网站的服务条款
  • 请实现请求速率限制(请求间隔至少300毫秒)。

Instalación

安装

bash
pip install requests

bash
pip install requests

Scripts

脚本

ScriptDescripción
fetch_sws.pyCliente completo: listar tickers, company detail, snowflake scores, análisis

脚本描述
fetch_sws.py完整客户端:列出股票代码、公司详情、Snowflake评分、分析数据

Uso rápido

快速使用

bash
undefined
bash
undefined

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

Buscar por nombre

通过名称搜索

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

Output a archivo

输出到文件

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

已发现的接口

EndpointMétodoDataStatus
/api/grid/filter?include=info,score,grid
POSTListado de empresas con scores y métricas✅ Funciona
/api/company{canonical_url}
GETDetail completo de una empresa✅ Funciona
接口请求方法返回数据状态
/api/grid/filter?include=info,score,grid
POST包含评分和指标的公司列表✅ 可用
/api/company{canonical_url}
GET公司完整详情✅ 可用

Includes disponibles para Company Detail

公司详情可用的附加数据项

IncludeData
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

附加项返回数据
info
公司简介、行业、国家、员工数、CEO
score
Snowflake评分(价值、收益、健康、过往表现、未来潜力、管理层)
analysis
股价、市值、市盈率(P/E)、市净率(P/B)、净资产收益率(ROE)、资产收益率(ROA)、每股收益(EPS)、股息、增长数据
analysis.extended
历史股息、派息率、股票回购、未来每股收益
analysis.extended.raw_data
历史财务报表
analysis.extended.raw_data.insider_transactions
内部交易数据

Cobertura

覆盖范围

CaracterísticaDetalle
Stocks globales120,000+ en 90+ mercados
Mercados Argentina✅ BASE (BCBA) tickers: GGAL, BMA, SUPV, YPFD, etc.
Mercados US✅ NasdaqGS, NYSE, AMEX
ActualizaciónDiaria (precio de cierre)
Snowflake scoresValue, Income, Health, Past, Future, Management
DividendosHistórico 19+ años, proyecciones futuras
Insider transactions✅ (cuando están disponibles)
AnalistasConsensus count y price targets

特性详情
全球股票覆盖90+市场的120,000+只股票
阿根廷市场✅ BASE(布宜诺斯艾利斯证券交易所)股票代码:GGAL、BMA、SUPV、YPFD等
美国市场✅ NasdaqGS、NYSE、AMEX
更新频率每日更新(收盘价)
Snowflake评分价值、收益、健康、过往表现、未来潜力、管理层
股息19+年历史数据、未来预测
内部交易✅(数据可用时)
分析师数据共识数量及目标价

Flags del script

脚本参数

FlagDescripció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)

参数描述
--ticker TICKER
逗号分隔的股票代码:GGAL 或 GGAL,BMA
--search QUERY
通过名称搜索
--full
获取所有可用的附加数据
--score
仅获取Snowflake评分
--info
仅获取公司信息
--analysis
仅获取分析指标
--extended
包含扩展数据
--raw-data
包含原始财务数据
--grid
通过grid/filter列出公司
--list-tickers
列出可用股票代码
--country AR
按国家筛选(仅适用于--grid)
--size N
每页大小(默认:24)
--limit N
结果数量限制
--download-snapshot
下载完整股票代码快照到
assets/
目录
--snapshot PATH
使用指定的快照文件(默认:自动在
assets/
目录查找)
--output archivo.json
保存输出结果
--csv
以CSV格式输出
--delay N
请求间隔时间(默认: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."

undefined
undefined

Info Corporativa

公司信息

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)

undefined
undefined

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

→ 股息历史、派息率、未来收益率

undefined
undefined

Todos los datos

完整数据

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:
bash
undefined
grid/filter返回可直接使用的公司列表,包含信息+评分+网格指标,一次请求即可获取。非常适合筛选器场景:
bash
undefined

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分钟)

bash
undefined
bash
undefined

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
undefined
python scripts/fetch_sws.py --download-snapshot
undefined

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)
API每个查询有10,000条记录的限制。为获取全部数据,脚本采用按交易所分区的方式:
  1. 阶段1:使用默认查询获取前10,000条记录 → 提取可用交易所
  2. 阶段2:针对每个交易所,获取所有公司(每个交易所的记录数<10,000)
  3. 去重:合并所有数据并按
    unique_symbol
    (交易所+股票代码)去除重复项

Resultados del snapshot
26-06-04

26-06-04快照结果

MétricaValor
Total listings únicos (
unique_symbol
)
78,454
Países cubiertos83
Exchanges106
Duplicados en el proceso de dedup0
Requests totales~944
Duración~11 min
Tamaño del CSV~6 MB
¿Por qué 78K y no 54K? El API reporta
total_records=54,530
para la query default (que filtra por scores mínimos). Pero al particionar por exchange con reglas más simples (
exchange_symbol=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.
指标数值
唯一上市股票总数(
unique_symbol
78,454
覆盖国家83
交易所数量106
去重过程中的重复项0
总请求数~944
耗时~11分钟
CSV文件大小~6 MB
为什么是78K而不是54K? 默认查询(按最低评分筛选)的API报告
total_records=54,530
。但通过更简单的规则按交易所分区(
exchange_symbol=X
+
primary_flag=true
),可以获取更多数据——包括ETF、基金、无评分公司和ADR。54K只是符合默认筛选条件的股票数量。

Verificación de calidad de datos

数据质量验证

ControlResultado
unique_symbol
duplicados
0 — dedup 100% efectivo
Mismo ticker + mismo exchange repetido3 casos — todos son falsos positivos (leading zeros:
115
0115
)
Tickers cross-listed (múltiples exchanges)8,751 — legítimo, una empresa listada en varios mercados
Países con más listingsUS (16,274), CN (7,016), IN (6,074), CA (5,221), JP (4,764)
检查项结果
unique_symbol
重复项
0 — 去重100%有效
同一股票代码+同一交易所重复3例 — 均为误判(前导零差异:
115
0115
交叉上市股票(多交易所)8,751 — 合法,同一公司在多个市场上市
上市股票最多的国家美国(16,274)、中国(7,016)、印度(6,074)、加拿大(5,221)、日本(4,764)

Sin snapshot

不使用快照的情况

Sin snapshot,
--ticker GGAL
tarda ~30s iterando el grid. Con snapshot, es instantáneo.
不使用快照时,
--ticker GGAL
需耗时约30秒遍历grid。使用快照则可即时响应。

Formato del snapshot

快照格式

CampoDescripción
ticker_symbol
Símbolo (GGAL, BMA, MSFT, etc.)
name
Nombre de la empresa
exchange_symbol
Exchange (BASE, NasdaqGS, NYSE)
canonical_url
Ruta API para company detail
unique_symbol
Exchange + Ticker (clave única)
country
Código ISO país
industry
Industria
employees
N° empleados
year_founded
Año fundación
score_value/income/health/past/future/management/total
Snowflake scores
share_price
Precio actual
market_cap
Market cap (moneda local)
pe_ratio
,
pb_ratio
Múltiplos
字段描述
ticker_symbol
股票代码(GGAL、BMA、MSFT等)
name
公司名称
exchange_symbol
交易所(BASE、NasdaqGS、NYSE)
canonical_url
公司详情API路径
unique_symbol
交易所+股票代码(唯一标识)
country
ISO国家代码
industry
行业
employees
员工数量
year_founded
成立年份
score_value/income/health/past/future/management/total
Snowflake评分
share_price
当前股价
market_cap
市值(当地货币)
pe_ratio
,
pb_ratio
估值倍数

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

交易所→国家映射

ExchangePaísListingsDescripción
OTCPK
US6,138OTC Markets Pink (EEUU)
TSE
JP4,693Tokyo Stock Exchange (Japón)
BSE
IN3,833BSE India (antes Bombay SE)
SZSE
CN3,723Shenzhen Stock Exchange (China)
SHSE
CN3,293Shanghai Stock Exchange (China)
SEHK
HK3,019Hong Kong Exchange
NYSE
US2,574New York Stock Exchange
ASX
AU2,527Australian Securities Exchange
TSX
CA2,381Toronto Stock Exchange (Canadá)
NasdaqGM
US2,304NASDAQ Global Market
NSEI
IN2,241National Stock Exchange of India
KOSE
KR2,075Korea Exchange (KOSPI)
TSXV
CA1,999TSX Venture Exchange (Canadá)
KOSDAQ
KR1,997KOSDAQ (Corea)
LSE
GB1,963London Stock Exchange
NasdaqCM
US1,854NASDAQ Capital Market
BATS
US1,575BATS Exchange (EEUU)
NasdaqGS
US1,532NASDAQ Global Select
BME
ES1,514Bolsas y Mercados Españoles
TPEX
TW1,430Taipei Exchange (Taiwán)
AIM
GB1,310AIM (London Stock Exchange)
TWSE
TW1,292Taiwan Stock Exchange
KLSE
MY1,172Bursa Malaysia
ENXTPA
FR1,147Euronext Paris
XTRA
DE1,135Xetra (Deutsche Börse)
BOVESPA
BR1,120B3 (Brasil)
TASE
IL1,029Tel Aviv Stock Exchange
SET
TH993Stock Exchange of Thailand
IDX
ID985Indonesia Stock Exchange
OM
SE852OMX Nordic (Estocolmo)
WSE
PL849Warsaw Stock Exchange
OB
NO811Oslo Børs (Noruega)
CNSX
CA777Canadian Securities Exchange
JSE
ZA754Johannesburg Stock Exchange
DB
DE648Deutsche Börse (Frankfurt)
SNSE
CL647Santiago Stock Exchange (Chile)
CPSE
DK636Copenhagen Stock Exchange
BIT
IT625Borsa Italiana
SWX
CH588SIX Swiss Exchange
IBSE
IE577Irish Stock Exchange
HOSE
VN572Ho Chi Minh Stock Exchange
HNX
VN417Hanoi Stock Exchange
SGX
SG398Singapore Exchange
DSE
BD443Dhaka Stock Exchange
DFM
AE70Dubai Financial Market
ADX
AE85Abu Dhabi Securities Exchange
BASE
AR84Bolsa de Buenos Aires (Argentina)
BMV
MX147Bolsa Mexicana de Valores
BVL
PE102Bolsa de Valores de Lima (Perú)
BVC
CO56Bolsa de Valores de Colombia
.........106 exchanges en total
El mapping completo de los 106 exchanges está en references/REFERENCE.md.

交易所国家上市数量描述
OTCPK
美国6,138OTC Markets Pink(美国)
TSE
日本4,693东京证券交易所(日本)
BSE
印度3,833印度孟买证券交易所
SZSE
中国3,723深圳证券交易所(中国)
SHSE
中国3,293上海证券交易所(中国)
SEHK
中国香港3,019香港交易所
NYSE
美国2,574纽约证券交易所
ASX
澳大利亚2,527澳大利亚证券交易所
TSX
加拿大2,381多伦多证券交易所(加拿大)
NasdaqGM
美国2,304NASDAQ全球市场
NSEI
印度2,241印度国家证券交易所
KOSE
韩国2,075韩国交易所(KOSPI)
TSXV
加拿大1,999TSX风险交易所(加拿大)
KOSDAQ
韩国1,997KOSDAQ(韩国)
LSE
英国1,963伦敦证券交易所
NasdaqCM
美国1,854NASDAQ资本市场
BATS
美国1,575BATS交易所(美国)
NasdaqGS
美国1,532NASDAQ全球精选市场
BME
西班牙1,514西班牙证券市场
TPEX
中国台湾1,430台湾证券柜台买卖中心
AIM
英国1,310AIM(伦敦证券交易所)
TWSE
中国台湾1,292台湾证券交易所
KLSE
马来西亚1,172马来西亚交易所
ENXTPA
法国1,147泛欧交易所巴黎
XTRA
德国1,135Xetra(德意志交易所)
BOVESPA
巴西1,120B3(巴西)
TASE
以色列1,029特拉维夫证券交易所
SET
泰国993泰国证券交易所
IDX
印度尼西亚985印度尼西亚证券交易所
OM
瑞典852OMX北欧交易所(斯德哥尔摩)
WSE
波兰849华沙证券交易所
OB
挪威811奥斯陆证券交易所(挪威)
CNSX
加拿大777加拿大证券交易所
JSE
南非754约翰内斯堡证券交易所
DB
德国648德意志交易所(法兰克福)
SNSE
智利647圣地亚哥证券交易所(智利)
CPSE
丹麦636哥本哈根证券交易所
BIT
意大利625意大利证券交易所
SWX
瑞士588SIX瑞士交易所
IBSE
爱尔兰577爱尔兰证券交易所
HOSE
越南572胡志明市证券交易所
HNX
越南417河内证券交易所
SGX
新加坡398新加坡交易所
DSE
孟加拉国443达卡证券交易所
DFM
阿联酋70迪拜金融市场
ADX
阿联酋85阿布扎比证券交易所
BASE
阿根廷84布宜诺斯艾利斯证券交易所(阿根廷)
BMV
墨西哥147墨西哥证券交易所
BVL
秘鲁102利马证券交易所(秘鲁)
BVC
哥伦比亚56哥伦比亚证券交易所
.........共106个交易所
完整的106个交易所映射请查看references/REFERENCE.md

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 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获取包含响应示例、字段说明和技术注意事项的完整文档。