fii·scanner B3 / Fundos Imobiliários

Sobre o fii·scanner

Esta ferramenta varre uma lista de FIIs procurando por combinações raras de sinais que historicamente precedem oportunidades de compra. Cada FII recebe um score de 0 a 4 baseado em quantos dos quatro critérios abaixo são atendidos. Quando o score atinge o threshold configurado, um alerta é enviado por Telegram. Tudo é determinístico, sem modelo preditivo — só regras explícitas.

Os 4 sinais

01

Z-score do preço atual

z(close) ≤ -1.5

Compara o preço atual com a média e desvio-padrão dos últimos 180 pregões. Z-score negativo = abaixo da média; mais negativo = mais barato em termos estatísticos. Dispara quando o preço está pelo menos -1.5 desvios abaixo da média móvel.

Fonte: yfinance · close diário ajustado
02

Queda recente sem notícia

drop(20d) ≤ -7.0% & news = ∅

Identifica quedas materiais (mais de 7.0% em 20 dias) que não são acompanhadas de notícias relevantes na janela de 14 dias. A ideia: se caiu mas ninguém escreveu sobre, pode ser ruído de mercado.

Fonte: yfinance + Google News RSS
03

P/VP descontado

P/VP ≤ 0.97

Preço sobre Valor Patrimonial. Abaixo de 0.97 indica que a cota está sendo negociada com desconto em relação ao valor contábil dos ativos do fundo. Sinal best-effort: se a fonte estiver indisponível, este critério é pulado e o score continua sendo calculado pelos outros 3.

Fonte: scrape Status Invest (cache 1h)
04

DY 12m acima da média

DY₁₂ₘ ≥ 1.15 × DY̅₃ᵧ

Compara o dividend yield dos últimos 12 meses com a média anualizada dos últimos 3 anos do próprio fundo. Dispara quando o DY atual está pelo menos 15% acima da média histórica — sinal de que o fundo está pagando mais que o típico.

Fonte: yfinance · dividendos pagos

Score & alerta

O score final é a soma dos sinais que dispararam (0 a 4). O Telegram só é disparado quando o score atinge o threshold configurado em config.MIN_SCORE_FOR_ALERT. Mesmo sem alerta, todas as rodadas são gravadas em data/history.csv (incluindo sinais não disparados) — você pode ver isso na aba Histórico.

MIN_SCORE_FOR_ALERT2
ZSCORE_WINDOW_DAYS180
ZSCORE_THRESHOLD-1.5
RECENT_DROP_WINDOW_DAYS20
RECENT_DROP_PCT_THRESHOLD-7.0%
PVP_MAX0.97
DY_PREMIUM_OVER_AVG1.15× (~15% acima)
NEWS_LOOKBACK_DAYS14

Fontes de dados

Tudo grátis, sem autenticação paga. As fontes são consultadas a cada rodada (cron ou botão "Rodar agora"); resultados ficam em CSV no host.

Histórico de preços + dividendosyfinance (Yahoo Finance)
P/VP atualStatus Invest (scrape HTML)
Notícias (validação de queda)Google News RSS pt-BR
Persistência de tickers e históricoCSV em data/ com flock
NotificaçãoTelegram Bot API

Limitações conhecidas

Nenhum sinal sozinho é suficiente — a tese é que a combinação deles tem mais valor que cada um isoladamente. Mesmo assim, score alto não é recomendação de compra: pode haver razões fundamentalistas para a queda que o scanner não captura (problemas com inquilino-âncora, mudança regulatória do setor, restrição de liquidez do fundo, etc.). Use como filtro inicial, não como decisão final.

Fundos na lista padrão

Os 30 FIIs abaixo são a lista default do config.DEFAULT_TICKERS. Você pode adicionar, ativar ou desativar tickers via Tickers. Para adicionar uma descrição customizada, edite fund_info.py.

TickerNomeTipoSegmentoGestora
PVBI11 VBI Prime Properties Tijolo Lajes corporativas premium VBI Real Estate
JSRE11 JS Real Estate Multigestão Tijolo Lajes corporativas premium Safra
HGRE11 CSHG Real Estate Tijolo Lajes corporativas premium Credit Suisse Hedging-Griffo
RCRB11 Rio Bravo Renda Corporativa Tijolo Lajes corporativas premium Rio Bravo
TEPP11 Tellus Properties Tijolo Lajes corporativas premium Tellus
GARE11 Guardian Real Estate Híbrido Logístico + varejo + 1 laje Guardian
TRXF11 TRX Real Estate Tijolo Varejo essencial (sale-leaseback) TRX
HGLG11 CSHG Logística Tijolo Galpões logísticos Credit Suisse Hedging-Griffo
XPLG11 XP Log Tijolo Galpões logísticos XP Asset Management
BTLG11 BTG Pactual Logística Tijolo Galpões logísticos BTG Pactual
VISC11 Vinci Shopping Centers Tijolo Shopping centers Vinci Partners
XPML11 XP Malls Tijolo Shopping centers XP Asset Management
KNRI11 Kinea Renda Imobiliária Híbrido Lajes corporativas + galpões logísticos Kinea Investimentos
HGRU11 CSHG Renda Urbana Híbrido Renda urbana (varejo + educação) Credit Suisse Hedging-Griffo
HGBS11 CSHG Brasil Shopping Tijolo Shopping centers Credit Suisse Hedging-Griffo
GGRC11 GGR Covepi Renda Tijolo Galpões logísticos (monousuário) GGR
RECR11 REC Recebíveis Papel CRIs high-yield REC Gestão
CPTS11 Capitânia Securities Papel CRIs (CDI) Capitânia
PORD11 Polo Recebíveis Papel CRIs high-yield Polo Capital
BTHF11 BTG Pactual Hedge Fund Híbrido Papel + cotas de FIIs BTG Pactual
KNCR11 Kinea Rendimentos Imobiliários Papel CRIs CDI Kinea Investimentos
HGCR11 CSHG Recebíveis Imobiliários Papel CRIs (CDI + IPCA) Credit Suisse Hedging-Griffo
CRAA11 CRA Agro Fiagro Fiagro — CRA n/d
RZTR11 Riza Terrax Fiagro Fiagro — terras agrícolas Riza
MXRF11 Maxi Renda Papel CRIs híbridos (CDI + IPCA) BTG Pactual
BCFF11 BTG Pactual Fundo de Fundos Fundo de Fundos Cotas de outros FIIs BTG Pactual
VILG11 Vinci Logística Tijolo Galpões logísticos Vinci Partners
ALZR11 Alianza Trust Renda Imobiliária Tijolo Híbrido (logístico + corporativo) Alianza Capital
RECT11 UBS BB Recebíveis Imobiliários Papel CRIs UBS BB
KFOF11 Kinea FoF Fundo de Fundos Cotas de outros FIIs Kinea Investimentos