Get the current stock price with daily change, 52-week range, and YTD return.

Args: ticker: Brazilian stock ticker (e.g. PETR4, VALE3, ITUB4)

Get fundamental indicators: P/L, P/VP, EV/EBITDA, ROE, margins, debt ratios, and more.

Returns 27+ indicators for Brazilian stocks. Uses the latest available data unless a specific reference_date is provided.

Args: ticker: Stock ticker (e.g. PETR4, VALE3) reference_date: Optional date (YYYY-MM-DD) for historical snapshot

Compare fundamental indicators across multiple stocks side by side.

Args: tickers: Comma-separated tickers, 2-5 (e.g. "PETR4,VALE3,ITUB4") metrics: Optional comma-separated metrics to show (e.g. "pl,pvp,roe,dividend_yield"). Available: pl, pvp, ev_ebitda, roe, roa, roic, net_margin, gross_margin, ebitda_margin, dividend_yield, close_price, lpa, vpa, debt_equity, p_sr

Get dividend history with yield, annual summary, and individual payments.

Works for both stocks and FIIs. FII tickers (ending in 11) are auto-detected.

Args: ticker: Stock or FII ticker (e.g. PETR4, HGLG11) years: Years of history (1-20, default 3)

Search for Brazilian listed companies by name or sector.

Use list_sectors first to see valid sector names.

Args: query: Search term for company name (e.g. "Petrobras", "banco") sector: Filter by sector (e.g. "Bancos", "Petróleo e Gás", "Energia Elétrica")

List all available sectors with company counts.

Use this to discover valid sector names for search_companies and screen_stocks.

Get historical OHLCV stock prices with adjusted values for splits and dividends.

Data available from 1986 to present.

Args: ticker: Stock ticker (e.g. PETR4) start: Start date (YYYY-MM-DD) end: End date (YYYY-MM-DD) limit: Max data points (default 30, max 5000)

Get FII (Real Estate Fund) details: P/VP, dividend yield, NAV, and distributions.

Args: ticker: FII ticker (e.g. HGLG11, KNRI11, MXRF11)

Get Brazilian macroeconomic indicator data.

Args: indicator: One of: selic, selic_target, ipca, cdi, usd_brl, eur_brl limit: Number of data points (default 30)

Get raw CVM financial statements (income, balance sheet, cash flow).

Args: ticker: Stock ticker (e.g. PETR4) statement_type: DRE (income), BPA (assets), BPP (liabilities), DFC_MI (cash flow), DVA (value added). Default: DRE. report_type: DFP (annual) or ITR (quarterly). Default: DFP. reference_date: Date (YYYY-MM-DD). Default: latest available.

Screen ALL Brazilian stocks by fundamental metrics. Scans ~264 companies in one call.

Args: filters: Comma-separated filters like "pl_lt=15,roe_gt=10,dividend_yield_gt=5". Supported metrics: pl, pvp, ev_ebitda, roe, roa, roic, net_margin, gross_margin, ebitda_margin, dividend_yield, debt_equity, net_debt_ebitda, market_cap, lpa, vpa, current_ratio, p_sr, cagr_revenue_5y, cagr_earnings_5y. Use _gt (greater than) or _lt (less than) suffix. sector: Sector filter (e.g. "Bancos", "Energia Elétrica", "Petróleo e Gás") sort: Sort by metric (default: market_cap). Any filterable metric works. order: "asc" or "desc" (default: desc) limit: Max results (default 20)