Retrieves historical price data (OHLCV) for a given symbol.

Args:
    symbol: The ticker symbol (e.g., 'AAPL', 'BTC-USD').
    interval: Data interval. Valid values: "1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo".
    period: Data period to download. Valid values: "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max".
    visualize: If True, returns a candlestick chart instead of raw data.
    
Returns:
    JSON string of OHLCV data or base64-encoded candlestick chart.

Retrieves core financial and fundamental data.

Args:
    symbol: The ticker symbol.
    
Returns:
    Dictionary containing fundamental data.

Fetches the current order book. 
NOTE: yfinance does not provide Level 2 data. This is a placeholder to demonstrate tool registration.

Args:
    symbol: The ticker symbol.
    
Returns:
    Message indicating unavailability.

Submits a market or limit order to Alpaca paper trading.

Args:
    symbol: Ticker symbol.
    side: 'buy' or 'sell'.
    qty: Quantity to trade.
    order_type: 'market' or 'limit'.
    limit_price: Required if order_type is 'limit'.
    
Returns:
    Confirmation message or error

Cancels a specific open order.

Args:
    order_id: The Alpaca order ID to cancel
    
Returns:
    Confirmation message

Retrieves the current state of all held positions and cash balance.

Returns:
    Dict with 'cash' and 'positions' keys

Immediately closes all open positions.

Returns:
    Summary of closed positions

Get order history from Alpaca.

Args:
    status: "all", "open", or "closed"
    
Returns:
    Formatted order history

Runs a Monte Carlo simulation using Geometric Brownian Motion (Log Returns).

Args:
    simulations: Number of paths to simulate.
    days: Number of days to project forward.
    visualize: If True, returns a histogram of final outcomes.

Backtests a Moving Average Crossover strategy.

Args:
    symbol: Ticker symbol
    fast_ma: Fast moving average period
    slow_ma: Slow moving average period  
    start_date: Backtest start date
    end_date: Backtest end date
    visualize: If True, returns equity curve chart

Calculates technical indicators for a symbol.

Args:
    symbol: Ticker symbol.
    indicators: List of indicators (e.g., ['RSI', 'MACD', 'BBANDS']).

Logs an agent action or reasoning step for audit purposes.

Args:
    action_type: Category (e.g., 'REASONING', 'TRADE_DECISION', 'ERROR').
    details: Description of the action.

Retrieves recent news headlines for a given symbol.

Args:
    symbol: Ticker symbol.
    max_items: Maximum number of news items to return.

Returns:
    JSON string of news articles with titles and publishers.

Analyzes the sentiment of a given text using FinBERT on Modal (via Public Endpoint).

Args:
    text: Text to analyze (e.g., news headline, article).

Returns:
    Dictionary with polarity, confidence, and classification.

Fetches recent news for a symbol and calculates aggregate sentiment.

Args:
    symbol: Ticker symbol.

Returns:
    Aggregate sentiment analysis of recent news.

Gets the current price of a cryptocurrency.

Args:
    coin_id: CoinGecko ID (e.g., 'bitcoin', 'ethereum', 'solana')
    vs_currency: Currency to compare against (default: 'usd')
    
Returns:
    Dictionary with price information

Gets comprehensive market data for a cryptocurrency.

Args:
    coin_id: CoinGecko ID (e.g., 'bitcoin', 'ethereum')
    
Returns:
    Formatted string with market data

Gets the top trending cryptocurrencies in the last 24 hours.

Returns:
    Formatted string with trending coins

Searches for cryptocurrencies by name or symbol.

Args:
    query: Search term (e.g., 'bitcoin', 'BTC', 'ethereum')
    
Returns:
    Formatted string with search results