brapi.dev - MCP de dados financeiros no seu SaaS

Get list of available Brazilian stocks, indexes, and financial instruments with advanced filtering options

Get list of available currency pairs for exchange rates

Get list of available cryptocurrencies

Get list of countries with available inflation data

Search and filter available B3 tickers in brapi. Use for autocomplete, ticker validation, and discovering stocks, FIIs, ETFs, BDRs, units, and indexes.

List known B3 ticker renames with old ticker, current canonical ticker, and effective date.

Resolve old B3 tickers to the current ticker recommended by brapi. Current tickers are returned unchanged.

Check which brapi data surfaces are available for each B3 ticker and get recommended endpoints.

List macroeconomic series available in brapi (slug, name, unit, frequency, category). Public — no auth required. Use this for discovery before calling get_macro_series. Optional `q` does case-insensitive substring search across slug, alias, name and description, with results ranked by relevance. Optional `category` filters by category. FX pairs are intentionally excluded — they live under the currency endpoints.

Get current and historical data for Brazilian stocks, indexes, or ETFs including price quotes, financial statements, and dividends

Get v2 stock quote snapshots from /api/v2/stocks/quote: price, change, volume, market cap, day range, 52-week range, and logo.

Get v2 OHLCV historical prices from /api/v2/stocks/historical for one or more B3 tickers.

Get v2 dividends/JCP for stock-like B3 tickers from /api/v2/stocks/dividends. Use get_fii_dividends for FIIs.

Get v2 company/profile fundamentals from /api/v2/stocks/profile.

Get v2 stock statistics from /api/v2/stocks/statistics, either current or historical.

Get v2 stock financial data from /api/v2/stocks/financial-data, either current or historical.

Get v2 balance sheet statements from /api/v2/stocks/balance-sheet.

Get v2 income statements from /api/v2/stocks/income-statement.

Get v2 cash-flow statements from /api/v2/stocks/cash-flow.

Get v2 value-added statements from /api/v2/stocks/value-added.

Get current exchange rates for currency pairs

Get current and historical cryptocurrency prices with market data

Get historical observations for Brazilian macroeconomic series (Selic, IPCA, IGP-M, CDI, IBC-Br, etc.). Pass slugs in `symbols` (comma-separated, e.g. `selic,ipca,igpm`). Use get_macro_series_catalog or search_macro_series to discover slugs. Currency pairs (USD-BRL etc.) are NOT served here — use the currency endpoints for FX series including inverses and cross-rates.

Get only the most recent observation for each requested macroeconomic series. Lighter than get_macro_series when you just need the current Selic / IPCA / CDI value. FX pairs are not served here — use the currency endpoints.

Get inflation data for Brazil (IPCA, IGPM) with period filtering options

Get Brazil's prime rate (SELIC) data with period and sorting options

List available option expiration dates for a given Brazilian underlying asset (stock, ETF, or index)

List available option strike prices for a given Brazilian underlying asset on a specific expiration date

Get the option chain (traded series with OHLCV snapshot) for a Brazilian underlying asset on a specific expiration date

Get daily EOD historical price data (OHLCV, bid/ask, trades, financial volume) for a single option series identified by its symbol and expiration date

Get EOD implied volatility and Greeks for traded Brazilian option series for an underlying asset on a specific expiration date. Fields are null with nullReason when the calculation cannot be produced from observed data.

Get the daily EOD implied volatility and Greeks time series for a single Brazilian option series identified by symbol and expiration date.

List available Brazilian futures contracts (mini Ibovespa, mini Dolar, full index/dollar, DI rate, agribusiness: boi, café, milho, soja). Paginated with filters by underlying asset and segment.

Get EOD snapshot quote for one or more Brazilian futures contracts. Returns OHLC, daily settlement price (AdjstdQt), settlement rate (AdjstdQtTax — populated for DI/rate-quoted contracts only), oscillation, number of trades, contract quantity, and financial volume.

Get contract specifications (without pricing) for one or more Brazilian futures: expiration date, contract multiplier (e.g., WIN = 0.2, BGI = 330 arrobas, DI1 = 1), allocation round lot, ISIN, CFI, trading currency, delivery type, and quotation type (price vs rate).

Get daily EOD time series for a single Brazilian futures contract. Each point has OHLC, settlement price, settlement rate (DI/DAP only), reference price, oscillation, trades, contract quantity and financial volume. For DI1/DAP/DI contracts, close/high/low fields hold the rate in %a.a., and settlement holds the PU in BRL.

Get the full term structure (all live contracts) for a Brazilian futures underlying asset. Returns one row per expiration, ordered by date ascending, each with the latest EOD pricing. Useful for plotting the DI yield curve, contango/backwardation in commodities, or the mini-Ibov forward curve.

List available option expiration dates for a Brazilian futures underlying (options on futures: e.g., options on BGI live cattle, ICF coffee, CCM corn, SJC soybean). These options have their own expiration calendar, often different from the underlying future.

List available strike prices for options on a Brazilian futures contract at a given expiration. Pair with get_futures_option_chain to fetch traded series with prices.

Get the option chain (traded series with last EOD prices) for a Brazilian futures underlying at a specific expiration. Each series carries optionStyle (american/european), strike, contractMultiplier, allocationRoundLot, plus OHLC/volume/oscillation from the latest pregão.

Get the daily EOD historical OHLC time series for a single option on a Brazilian futures contract. Returns the option specs (strike, optionStyle, expiration, multiplier) plus traded-day points (referencePrice + OHLC + oscillation + trades + financial volume). Days where the option didn't trade aren't included — most futures options have sparse history.

Get EOD implied volatility and Greeks for options on Brazilian futures for an underlying asset at a specific expiration. European options use Black-76; American options use a binomial futures model. Fields are null with nullReason when the calculation cannot be produced from observed data.

Get the daily EOD implied volatility and Greeks time series for a single option on a Brazilian futures contract.

List Brazilian Real Estate Investment Funds (FIIs) with optional filters by symbols, CNPJs, segment type, sector, mandate and management type. Returns paginated results with current indicators (price, P/VP, dividend yield) and administrator info. Use get_funds_list for FI-Infra/FIF, FIAGRO, FIDC and FIP funds such as JURO11.

Get current fundamental indicators for one or more Brazilian Real Estate Investment Funds (FIIs). Returns P/VP (price-to-NAV), dividend yield (12m and 1m), monthly return, equity, total assets, total investors, and administrator info.

Get monthly historical evolution of fundamental indicators (price, P/VP, dividend yield, monthly return, total investors, equity, total assets) for one or more Brazilian FIIs. Useful for charting trends and comparing periods.

Get daily OHLCV historical price data for one or more Brazilian Real Estate Investment Funds (FIIs). Returns open, high, low, close, volume and adjusted close per day, grouped by symbol.

Get FII physical properties with vacancy first-class: area, address, unit count, vacancy rate, delinquency rate, revenue share and consolidated area-weighted vacancy. Rate fields are decimal ratios (0.0328 = 3.28%). Best endpoint for brick-and-mortar FII vacancy analysis.

Get quarterly time series of FII physical-property summaries: property count, total area, area-weighted vacancy, average vacancy and number of properties with vacancy data. Best for charting vacancy trends before drilling into get_fii_properties.

Get normalized FII portfolio composition grouped by fund: summary, allocations, CRIs, FII fund holdings, properties, lands and rights. Best for FoFs, paper FIIs, issuer concentration and full holdings analysis.

Get quarterly time series of normalized FII portfolio summaries: total items, declared value, property summary, financial-asset summary and allocations by asset class. Best for charting portfolio composition before drilling into get_fii_portfolio.

Get monthly CVM management reports for Brazilian FIIs with full asset composition (real estate, CRI, LCI, fund holdings, cash, government/private bonds), profitability (monthly return, monthly dividend yield), fees and liabilities. Most comprehensive endpoint for due diligence.

Get historical dividends (rendimentos and amortizações) for one or more Brazilian FIIs. Returns rate per share, ex-dividend date (lastDatePrior), payment date and label. Note: paymentDate reflects the competence reference (1st of month) — actual credit dates vary by administrator (typically 4-14 days after lastDatePrior).

List Brazilian funds across FIIs, FIAGROs, FI-Infra/FIFs, FIDCs and FIPs. Use for discovery by symbol, CNPJ, search text or asset type.

Get current indicators for specific Brazilian funds. Requires symbols or cnpjs; returns market price, NAV per share, P/NAV, equity, assets and investor count.

Get NAV history for specific funds. FI/FIF data is daily; FIDC data is monthly by quota class or series and includes official monthly return. Requires symbols or cnpjs; market OHLCV price is separate from NAV.

Get monthly profile sections for specific FI/FIF funds. Requires symbols or cnpjs; includes investor breakdown, risk, liquidity, concentration and private-credit exposure.

Get holdings for specific FI/FIF funds grouped into public bonds, fund holdings, credit assets, listed securities, receivables and payables. Requires symbols or cnpjs.

Get exact official dividend events for non-FII listed funds such as FIAGRO, FI-Infra/FIF, FIDC and FIP. Returns declared date, ex-date (lastDatePrior), payment date, rate and label. Use get_fii_dividends for FIIs.

Get monthly FIAGRO reports for specific funds by symbol or CNPJ, including PL, NAV, investors and monthly DY.

Get grouped FIAGRO allocation sections for specific funds. Requires symbols or cnpjs; includes agro credit, maturity, liabilities and investor breakdown.

Get monthly FIDC report rows for specific funds by CNPJ, or by symbol when listed mapping exists.

Get FIDC grouped portfolio/risk sections for specific funds. Requires symbols or cnpjs; includes sectors, maturity, delinquency, risk, quota classes and investors.

Get structured FIP report rows for specific funds. Requires symbols or cnpjs; CNPJ is the canonical lookup key for most FIPs.

Get FII DFIN financial reports by symbol or CNPJ. Does not include FIAGRO, FI-Infra, FIDC or FIP rows.

Get FII annual report rows by symbol or CNPJ. These are separate from monthly reports and quarterly portfolio/properties endpoints.

List Tesouro Direto public bonds with current indicative rates and prices. Supports filtering by public symbol/name, indexer (selic, prefixado, ipca, igpm), coupon type, sorting and pagination.

Get the latest indicative rates and prices for one or more Tesouro Direto public bonds. Symbols are public brapi slugs like tesouro-selic-01032031.

Get daily historical Tesouro Direto rates and unit prices for one or more public bonds. When dates are omitted, returns the last 12 months.