Get the current price and day change for a stock ticker.

Args: ticker: Ticker symbol, e.g. 'AAPL', 'MSFT', or 'PETR4.SA' for B3-listed stocks.

Returns the latest price, previous close, absolute and percentage change, and currency. Returns an {"error": ...} payload if the ticker is invalid or the data provider is unreachable.

Compute risk/return metrics for a weighted portfolio of stocks.

Args: tickers: Ticker symbols in the portfolio, e.g. ['AAPL', 'MSFT']. weights: Portfolio weight per ticker, same order, must sum to 1.0. period: Lookback window: one of '1mo','3mo','6mo','1y','2y','5y','10y','ytd','max'. risk_free_rate: Annualized risk-free rate for the Sharpe ratio (e.g. 0.1075 for 10.75%).

Returns cumulative return, annualized return, annualized volatility, Sharpe ratio, and max drawdown for the combined portfolio.

Compute the correlation matrix of daily returns between two or more assets.

Args: tickers: Two or more ticker symbols to correlate, e.g. ['AAPL', 'MSFT', 'GOOGL']. period: Lookback window: one of '1mo','3mo','6mo','1y','2y','5y','10y','ytd','max'.

Returns a ticker-by-ticker correlation matrix of daily returns (-1 to 1).

Get a summarized price history for one ticker: moving averages, high/low, and return.

Args: ticker: Ticker symbol, e.g. 'AAPL' or 'VALE3.SA'. period: Lookback window: one of '1mo','3mo','6mo','1y','2y','5y','10y','ytd','max'.

Returns the 20/50-day simple moving averages, period high/low close, and cumulative return over the window. Moving averages are null when there isn't enough history for that window.