B3 Brazil Stock Screener

Screen B3 (Brazil) stocks by market cap, valuation and fundamentals. Built for analysts, quant researchers, fintech builders and AI agents. Factual public data — not financial or investment advice.

📊 Sample Output

yahoo_symbol	company_name_pt	share_class	exchange_full_name	country	liquidity_2m_brl
PETR4.SA	PETROBRAS	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	2010450000
VALE3.SA	VALE	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	1507170000
ITUB4.SA	ITAUUNIBANCO	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	1012170000
BBDC4.SA	BANCO BRADESCO S.A.	PN (Preferencial / preferred)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	678572000
AXIA3.SA	AXIA ENERGIA	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	676366000
BBAS3.SA	BANCO DO BRASIL S.A.	ON (Ordinária / common, voting)	Brasil, Bolsa, Balcão (Bovespa)	Brazil	648704000

Real rows from run BgT2vfj4ka6IXNmKa on build 0.0.10 (2026-09-24), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty.

🔧 Input reference

Field	Type	Default	What it does
limit	integer	100	Maximum number of B3 (Brasil, Bolsa, Balcão / Bovespa) listed stocks to return. The Brazilian exchange has roughly 400-450 listed common stocks plus preferred shares (PETR4, VALE3…
min_market_cap_brl	integer	0	Filter to stocks with patrimônio líquido (book equity, in BRL) at or above this threshold. Used as a market-cap proxy from Fundamentus. Examples: 1000000000 = 1bn BRL (mid-cap flo…
min_liquidity_2m_brl	integer	0	Filter to stocks with Liq.2meses (mean daily traded value over the last 2 months in BRL) at or above this threshold. Excellent for excluding illiquid micro-caps. Examples: 1000000…
max_pe_ratio	number	0	Filter to stocks with P/L (Preço/Lucro, P/E) at or below this value (value-investor screen). Examples: 8 = deep value typical of Brazilian banks/utilities, 15 = classic Graham val…
max_pvp_ratio	number	0	Filter to stocks with P/VP (Preço/Valor Patrimonial, P/B) at or below this value. Brazilian banks often trade at 0.8-1.5 P/VP. Examples: 1 = trading below book, 2 = reasonable. Le…
min_dividend_yield	number	0	Filter to stocks with trailing dividend yield at or above this value (in percent). Brazil is famous for its high-yield equity culture — utilities (TAEE11, ENBR3), banks (ITSA4, BB…
min_roe_pct	number	0	Filter to stocks with Return on Equity at or above this value (in percent). Quality-investor screen. Examples: 15 = good quality, 20 = top-tier (Itaú, WEG, Localiza historically).…
sector	string	""	Optional case-insensitive substring filter applied to the ticker (Papel) and company name. Examples: 'PETR' (Petrobras family — PETR3/PETR4), 'BANCO' (banks), 'VALE', 'ITAU', 'ENE…
proxyConfiguration	object	{"useApifyProxy": true}	Apify proxy configuration. Fundamentus.com.br is a public Brazilian server-rendered site and accepts datacenter proxies fine. Switch to RESIDENTIAL only if you hit rate limits.

🧾 JSON sample record

One real record from run BgT2vfj4ka6IXNmKa (emails/phones masked, long text shortened):

{
  "symbol": "PETR4",
  "yahoo_symbol": "PETR4.SA",
  "company_name_pt": "PETROBRAS",
  "root_ticker": "PETR",
  "share_class": "PN (Preferencial / preferred)",
  "market": "B3",
  "exchange_full_name": "Brasil, Bolsa, Balcão (Bovespa)",
  "country": "Brazil",
  "currency": "BRL",
  "price_brl": 49.26,
  "pe_ratio": 4.76,
  "pvp_ratio": 1.32,
  "psr": 1.158,
  "dividend_yield_pct": 7.4,
  "p_ativo": 0.496,
  "p_cap_giro": -24.05,
  "p_ebit": 2.71,
  "p_ativ_circ_liq": -0.99,
  "ev_ebit": 4.04,
  "ev_ebitda": 2.94,
  "gross_margin_pct": 50.6,
  "ebit_margin_pct": 42.76,
  "net_margin_pct": 24.39,
  "current_ratio": 0.85,
  "roic_pct": 19.69,
  "roe_pct": 27.73,
  "liquidity_2m_brl": 2010450000,
  "book_equity_brl": 480950000000,
  "net_debt_to_equity": 0.65,
  "revenue_growth_5y_pct": -2.33,
  "fundamentus_url": "https://www.fundamentus.com.br/detalhes.php?papel=PETR4",
  "b3_url": "https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/empresas-listadas.htm?codigo=PETR4",
  "yahoo_finance_url": "https://finance.yahoo.com/quote/PETR4.SA",
  "scraped_at": "2026-09-24T23:53:50.931367Z"
}

💰 Pricing

Event	Price (USD)	When it is charged
Actor Start (apify-actor-start)	$0.01	Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
B3 stock record (apify-default-dataset-item)	$0.25	Charged per B3 stock record returned with price, market cap, P/E, P/B, dividend yield, sector, and fundamentals.

Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.25 = $25.00 plus the start fee.

🔗 Related Actors

More from the NexGenData Asia-Pacific markets & registries family:

• ASX Australia Stock Screener — ASX 200 Data API
• ASX Announcements Scraper — Australian Company Disclosures
• Australia ASIC Company Search — Registry API
• BIST Turkey Stock Screener — BIST 100 Data API
• BMV Mexico Stock Screener — S&P/BMV IPC Data API
• Bursa Malaysia Stock Screener — KLCI Data API

32 more in this family on the NexGenData Store page.

📊 What you get

Clean JSON, one record per stock. Key fields (full output has 34 fields per stock):

• root_ticker — Exchange ticker symbol
• company_name_pt — Company name
• price_brl — Latest traded price (local currency)
• pe_ratio — Price-to-earnings ratio
• dividend_yield_pct — Dividend yield (%)
• roe_pct — Return on equity
• currency — Reporting currency
• scraped_at — Data timestamp
• b3_url — Source / reference URL

All prices in BRL.

Local-market specifics: Deep fundamentals — ROE, ROIC, EV/EBIT, P/VP and margins — sourced from Fundamentus, with Portuguese company names.

Pricing: $0.25 per stock (Pay-Per-Event) — about 4 stocks per $1. A $0.01 actor-start fee applies per run.

🤖 Use with AI agents

This actor returns structured JSON built for LLM and agent pipelines — no data-vendor contract, no scraping to maintain. Point Claude, a custom OpenAI Agents SDK tool, an n8n flow, or any MCP-aware client at it and get Ibovespa fundamentals on demand. Ask for a filtered slice and the agent gets exactly the rows it needs.

Sample agent prompt:

Screen the Ibovespa for dividend yield > 4% and market cap > $1B, return the top 20 as JSON.

Agentic payments (x402): Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

⏰ Run on a schedule

Refresh your screen weekly with a scheduled run:

{
  "limit": 50
}

🔗 Related screeners

Other Americas exchanges: Canada (TSX), Mexico (BMV), US (Finviz)

All 25+ markets in one place: Global Equities Screener MCP — the agent front door to every NexGenData screener.

---

Data sourced from public market pages and filings. Factual public data — not financial or investment advice.