Get the current real-time price for any trading symbol.

Supports forex pairs, precious metals, crypto, and stocks. This is the fastest endpoint for getting current prices.

Symbols examples:

• Metals: XAU/USD (gold), XAG/USD (silver), XPT/USD (platinum)

• Forex: EUR/USD, GBP/USD, USD/JPY

• Crypto: BTC/USD, ETH/USD

• Stocks: AAPL, MSFT, GOOGL

Args:

• symbol (string): Trading symbol (e.g., "XAU/USD", "EUR/USD", "BTC/USD")

• response_format ('markdown' | 'json'): Output format

Returns: Current price of the symbol.

Examples:

• "What's the current gold price?" -> symbol: "XAU/USD"

• "Get EURUSD price" -> symbol: "EUR/USD"

• "Bitcoin price now" -> symbol: "BTC/USD"

Get comprehensive quote data including OHLC, change, volume, and 52-week range.

More detailed than get_price - includes open, high, low, close, previous close, change percentage, and market status.

Args:

• symbol (string): Trading symbol (e.g., "XAU/USD", "EUR/USD")

• response_format ('markdown' | 'json'): Output format

Returns: Detailed quote with:

• Current price (close)

• Open, High, Low

• Previous close

• Change and percent change

• Volume (if available)

• 52-week range (if available)

• Market open/closed status

Examples:

• "Get full gold quote" -> symbol: "XAU/USD"

• "EURUSD detailed info" -> symbol: "EUR/USD"

Get historical OHLC (Open, High, Low, Close) candlestick data.

Perfect for chart analysis, backtesting, and historical price research. Supports multiple timeframes from 1-minute to monthly data.

Args:

• symbol (string): Trading symbol

• interval (string): Candle interval - "1min", "5min", "15min", "30min", "1h", "4h", "1day", "1week", "1month"

• outputsize (number): Number of candles to return (1-5000, default: 30)

• start_date (string, optional): Start date YYYY-MM-DD

• end_date (string, optional): End date YYYY-MM-DD

• response_format ('markdown' | 'json'): Output format

Returns: Array of OHLC candles with datetime, open, high, low, close, and volume (where applicable).

Examples:

• "Get 1-hour gold candles" -> symbol: "XAU/USD", interval: "1h"

• "Daily EURUSD last 100 days" -> symbol: "EUR/USD", interval: "1day", outputsize: 100

• "5-minute BTC data" -> symbol: "BTC/USD", interval: "5min"

Convert an amount from one currency to another using real-time rates.

Supports fiat currencies, precious metals (XAU, XAG), and cryptocurrencies.

Args:

• from (string): Source currency code (e.g., "USD", "EUR", "XAU", "BTC")

• to (string): Target currency code

• amount (number): Amount to convert

• response_format ('markdown' | 'json'): Output format

Returns: Converted amount with exchange rate.

Examples:

• "Convert 1000 USD to EUR" -> from: "USD", to: "EUR", amount: 1000

• "How much is 1 oz gold in USD?" -> from: "XAU", to: "USD", amount: 1

• "Convert 0.5 BTC to USD" -> from: "BTC", to: "USD", amount: 0.5

Get the current exchange rate for a currency pair.

Args:

• symbol (string): Currency pair (e.g., "EUR/USD", "XAU/USD")

• response_format ('markdown' | 'json'): Output format

Returns: Current exchange rate with timestamp.

Examples:

• "EUR/USD exchange rate" -> symbol: "EUR/USD"

• "Gold rate" -> symbol: "XAU/USD"

Get a list of all available commodities including precious metals, energy, and agricultural products.

Args:

• response_format ('markdown' | 'json'): Output format

Returns: List of commodities with symbols, names, and categories. Categories include: Precious Metal (gold, silver, platinum), Energy (oil, natural gas), Agricultural, etc.

Examples:

• "What metals can I trade?" -> lists all available commodities

• "Show available commodities" -> full list

Calculate technical indicators for a symbol.

Supports popular indicators for technical analysis.

Available indicators:

• Trend: SMA, EMA, WMA, ADX

• Momentum: RSI, MACD, MOM, ROC, STOCH, WILLR, CCI

• Volatility: BBANDS (Bollinger Bands), ATR

• Volume: OBV

Args:

• symbol (string): Trading symbol

• interval (string): Time interval for calculation

• indicator (string): Indicator type (sma, ema, rsi, macd, bbands, stoch, adx, atr, etc.)

• time_period (number): Period for calculation (default: 14)

• outputsize (number): Number of data points (default: 30)

• response_format ('markdown' | 'json'): Output format

Returns: Indicator values with timestamps.

Examples:

• "RSI for gold" -> symbol: "XAU/USD", indicator: "rsi"

• "MACD for EURUSD daily" -> symbol: "EUR/USD", indicator: "macd", interval: "1day"

• "20-period SMA for BTC" -> symbol: "BTC/USD", indicator: "sma", time_period: 20