Dados B3 › Who is it for

Who is it for

Who Dados B3 is for — and who it is not

Dados B3 publishes the fundamentals of the Brazilian stock market — 356 company pages, 468 REITs (FIIs) and 159 ETFs — with the regulator's account behind every figure. This page says who it serves, who it does not, and what it costs.

If you build software or run models

You get a REST API that returns JSON, an official Python package (pip install dadosb3), a full CSV dump, and an MCP connector with 19 tools. Ratios, multiples, dividends, Piotroski and Graham scores, quarterly series and balance-sheet restatements, 2010 to date. Multiples are point-in-time: the price is the one you could have paid on the first session after the filing reached the CVM. Every number has a lineage page down to the line of the CVM file, and nothing is published before the invariant suite passes.

Limits, said upfront: end-of-day prices only; no survivorship treatment (companies that left the exchange are absent); no historical index composition; the base starts in 2010.

Start: WEGE3 is open without a key in HTML and JSON; a free key gives 200 queries a day; the API documentation and the MCP guide are one page each.

pip install dadosb3

from dadosb3 import DadosB3
DadosB3().indicadores("WEGE3")   # no key needed

# or plain HTTP:
curl -H "Accept: application/json" https://dadosb3.com/acoes/WEGE3

If you invest and want to check a number yourself

Each company has an open page — ROE, ROIC, margins, debt, multiples with the session date used, dividends per year, restated statements — at /acoes/TICKER. REITs have point-in-time P/B and 12-month yield from the monthly CVM filing; ETFs have the daily NAV, premium or discount, the effective fee from the trial balance and the monthly portfolio. Screeners and pair comparisons order by declared criteria. None of it is a recommendation.

If you write, teach or research

The audit protocol lets you draw your own sample (the seed is yours) and check each case against the CVM file. Restatements keep both versions of a republished statement; what we got wrong is dated and public. The data is ODbL: cite the source and share alike.

When not to use Dados B3

• You need intraday or real-time quotes — we only have end-of-day.
• You need price history before 2010 — other sources go back to 1986.
• You need insider trades, DVA or a 160-indicator catalogue — we cover fewer fields, each with its formula published.
• You need a survivorship-free universe for a full backtest — we do not reconstruct delistings.
• You need an institutional terminal with support desk — that is another product category.

The comparison page names who does each of those better than us, with links and the date we checked.

Price

Free key: 200 queries a day, no card, no expiry. Pro: R$ 49.90 a month, 10,000 queries a day, 7-day money-back guarantee — /assinar. Pages, methodology and audit are open to everyone.

Questions people ask

Is Dados B3 free?

Yes, for most uses. Every company page (/acoes/TICKER, 356 of them), every FII and ETF page, the methodology, the audit sample and the trust pages open with no key. The JSON API needs a key: the free key gives 200 queries a day with no card; Pro is R$ 49.90/month for 10,000 a day with a 7-day money-back guarantee.

Where does the data come from?

Financial statements from the CVM's open data (ODbL licence), prices from B3's end-of-day COTAHIST file, FII monthly filings from the CVM, ETF daily filings from FNET. Every figure carries the CVM account it came from.

Does it have real-time or intraday prices?

No. Prices are end-of-day only, by design. For intraday quotes use a quote API (the comparison page names them).

Can I run a backtest on it?

Partly. Multiples are point-in-time (the price of the first session on or after the filing actually reached the CVM), which removes the look-ahead between statement and price. The universe is NOT survivorship-free: companies that left the exchange are not in the base, and there is no historical index composition.

How do I connect it to Claude, ChatGPT or Cursor?

Add the remote MCP connector https://dadosb3.com/mcp/ or run the open-source local server. It exposes 19 tools: company ratios, multiples, dividends, scores, restatements, quarterly series, FIIs, ETFs, screeners and the methodology.

Is it investment advice?

No. Rankings and screeners are descriptive, ordered by declared criteria, and every number links to the filing behind it.