Get the current price and 24-hour trading stats for a crypto trading pair from Binance.

This tool fetches a live snapshot: last traded price, 24h price change (absolute and %), 24h high/low, and 24h volume. It does NOT return historical data — use binance_get_historical_ohlc for that.

Args:

• symbol (string, optional): Trading pair, e.g. "BTCUSDT". Defaults to "BTCUSDT".

Returns: { "symbol": string, "price": number, // last traded price "price_change_24h": number, // absolute change over 24h "price_change_percent_24h": number, // % change over 24h "high_24h": number, "low_24h": number, "volume_24h_base": number, // volume in base asset (e.g. BTC) "volume_24h_quote": number, // volume in quote asset (e.g. USDT) "as_of": string // ISO 8601 timestamp of this snapshot }

Examples:

• Use when: "what's the current BTC price" -> symbol="BTCUSDT" (or omit, it's the default)

• Use when: "check ETH price" -> symbol="ETHUSDT"

• Don't use when: you need price history over time (use binance_get_historical_ohlc)

Error Handling:

• Returns "Error: ..." text if the symbol is invalid or Binance is rate-limiting.

Get historical OHLC (open/high/low/close) candles for a crypto trading pair from Binance, for a given date range and interval.

Use this to build price series for indicator calculation (momentum, moving averages, volatility models like EGARCH) or backtesting. Automatically paginates past Binance's 1000-candle-per-request limit. Caps total candles returned at 2000 per call — if your range would exceed that, the response is truncated and "truncated": true is set; split the request into smaller date ranges if you hit this.

Args:

• symbol (string, optional): Trading pair, e.g. "BTCUSDT". Defaults to "BTCUSDT".

• interval (string, optional): Candle size — "1h", "4h", "1d", or "1w". Defaults to "1d".

• start_date (string, required): Start date, format YYYY-MM-DD. BTCUSDT data begins 2017-08-17.

• end_date (string, required): End date, format YYYY-MM-DD.

Returns: { "symbol": string, "interval": string, "requested_start": string, "requested_end": string, "candle_count": number, "truncated": boolean, // true if more candles existed than were returned "note": string (optional), // present if truncated or range predates available data "candles": [ { "open_time": string, // ISO 8601 "open": number, "high": number, "low": number, "close": number, "volume": number, "close_time": string, // ISO 8601 "quote_volume": number, "trade_count": number } ] }

Examples:

• Use when: "get me 5 years of daily BTC prices" -> symbol="BTCUSDT", interval="1d", start_date="2020-01-01", end_date="2025-01-01"

• Use when: "weekly BTC candles for the last 2 years" -> interval="1w" with an appropriate date range

• Don't use when: you just need the current price (use binance_get_current_price)

Error Handling:

• Returns "Error: ..." text if dates are malformed, start is after end, or Binance is rate-limiting.

• If start_date predates 2017-08-17, the response will include a "note" explaining the series starts later than requested.