Dados B3

The latest Material Facts (Fato Relevante) or market notices (Comunicado ao Mercado) that Brazilian listed companies filed at CVM, newest first, each with company, subject (the company's own text), filing date, protocol and the LINK TO THE ORIGINAL DOCUMENT at CVM. `ticker` filters by company (e.g. PETR4); `category` is "Fato Relevante" or "Comunicado ao Mercado"; `limit` is between 1 and 100. No summary or impact reading. CVM updates this open data WEEKLY and gives the date, not the time.

get_material_facts

Oil and natural gas production in Brazil by operator and by field, from the ANP (national petroleum agency) open data. Average DAILY rate of the month: oil in bbl/day, gas in thousand m3/day. No arguments: the operators of the latest month, with share of the national total and year-over-year change. `level="campo"` returns fields; `period` (YYYY-MM) another month. `cnpj` (14 digits), `operator` (name at ANP) or `field` return the MONTHLY series, cut by `start_date`/`end_date` (YYYY-MM). From 2024 on coverage per field is PARTIAL: each row carries `fonte` and `escopo`. `ticker` is filled only when the operator's CNPJ is that of a listed company.

get_oil_gas_production

Mobile phone and fixed broadband connections (active lines and accesses) per operator, month by month, from Anatel (telecom regulator) open data. No arguments: the ranking of each service in the latest consolidated month, with share of the total and 12-month change. `service` (movel or banda_larga) + `cnpj` (14 digits, or TOTAL for all operators) returns the MONTHLY series of that operator, cut by `start_date`/`end_date` (YYYY-MM). Mobile excludes M2M. The newest month is preliminary. `ticker` is filled only when the operator's CNPJ is that of a listed company (e.g. VIVT3, TIMS3).

get_telecom_connections

Yearly series (2010 to the latest fiscal year) of ROIC, ROE, gross, EBIT and net margins, revenue growth and net debt/EBITDA of a stock listed on B3, with quality flags, plus the provenance of each indicator (formula, CVM accounts, profit base). Stocks only: for a real estate fund (ticker ending in 11, such as HGLG11) use get_real_estate_fund. Banks and insurers come without ROIC and EBITDA, which do not apply to their chart of accounts. Works for any listed ticker.

get_annual_indicators

Machine-readable methodology of every indicator: formula, CVM accounts used and the profit base of each one. Important to compare numbers correctly: net margin uses TOTAL consolidated profit; ROE uses profit attributable to the controlling shareholders.

get_data_dictionary

Standardized accounts of a stock listed on B3 (revenue, EBIT, net income, equity, debt, cash...), each number with the exact CVM account it came from, so it can be audited end to end. `quarterly=False` reads the annual statements (DFP); `quarterly=True` reads the quarterly ones (ITR, Q1 to Q3 isolated). The current version of each period. Stocks only. Works for any listed ticker.

get_financial_statements

The public methodology behind the numbers (formulas, CVM accounts, edge cases), in English. Without a topic, lists the available topics; with a topic (e.g. 'roic', 'dividendos', 'multiplos', 'margens'), returns the full text in Markdown.

get_methodology

Performance of a B3 market index (IBOV, IFIX, SMLL, IDIV, IBXX...) over a period: return, maximum drawdown and volatility of buy-and-hold and of a moving-average crossover (default 21 x 100). Default period: last 5 years. Use it as the benchmark when comparing a stock or a strategy. These are total return indices (B3 reinvests distributions in the points). Use list_indices for the available codes.

get_index_performance

Performance of a B3 stock over a period in a few numbers computed on the server: return, annualized return, maximum drawdown (with dates) and volatility of buy-and-hold, and the same for a moving-average crossover (default 21 x 100 sessions). Default period: last 5 years. Prices adjusted for splits and other corporate events; price return and, when dividends are recorded, total return with dividends reinvested. No costs or taxes. Dates as YYYY-MM-DD. Works for any listed ticker. A measure of the past only.

get_stock_performance

Point-in-time valuation multiples of a stock listed on B3: yearly P/E, P/B and EV/EBITDA, and quarterly trailing 12-month P/E, each priced at the first trading session AFTER the statement became public at CVM, so there is no look-ahead. Stocks only: for the P/B of a real estate fund use get_real_estate_fund. Works for any listed ticker.

get_valuation_multiples

What BRL 1,000 invested in a stock, real estate fund or ETF listed on B3 became 1, 3, 5 and 10 years ago: price only and with distributions reinvested, against the Ibovespa (IFIX for real estate funds) and the Selic target rate, up to the latest close. The same numbers as the public page; for another period use get_stock_performance. No costs or taxes. Returns the text in Markdown.

get_growth_of_1000

List the B3 market indices available (IBOV, IFIX, SMLL, IDIV...), with name, number of sessions and the first and last date of each series. Use the code with get_index_performance.

list_indices

List BDRs (Brazilian depositary receipts of foreign stocks and ETFs, e.g. AAPL34, NVDC34, IVVB39) that traded on B3 in the last year, most liquid first, with type, last close and average daily volume. `bdr_type` filters: DRN (unsponsored), DR1/DR2/DR3 (sponsored level I/II/III), DRE (ETF BDR). `limit` is between 1 and 1000 (default 100). Descriptive only.

list_bdrs

List the Brazilian publicly listed companies (stocks only, not real estate funds), with CVM code, name and main B3 ticker when there is one. Use it to find the ticker of a company before calling the other tools. The count comes in the answer.

list_companies

Companies that LEFT the Brazilian stock exchange (stopped trading on B3), by year of the LAST trading session: those whose public company registration was cancelled at CVM (with CVM date and reason) and those that stopped trading with the registration still active (move abroad, merger, tender offer). No `year`: the 3 latest years. With `year`: only that year (within those 3).

list_delisted_companies

Brazilian real estate investment funds (FIIs): lowest P/B, highest 12-month distribution yield and the median P/B and yield by segment. Only liquid funds and clean values (no quality flag) enter. Descriptive only.

get_real_estate_fund_rankings

ETFs listed on B3: most traded, largest net assets, largest discount and premium to NAV (price vs NAV per share of the SAME day), 12-month return by NAV (total return by construction) and lowest EFFECTIVE expense ratio (expenses from the fund's balance sheet over average net assets, annualized). Only liquid ETFs (over BRL 1 million/day) enter premium, return and expense rankings. Descriptive only.

get_etf_rankings

What changed in the Brazilian market in the last 30 days: financial statements made public (with the filing date at CVM), statements re-filed by the company, cash dividends approved, real estate fund distributions and reports, corporate events (splits, reverse splits, bonus issues) and ticker changes. Each section declares `dados_ate`, the latest date of that source.

get_market_today