Analyze market structure: swing highs/lows, trend, BOS / CHoCH.

Builds an alternating swing sequence from confirmed pivots, labels each as HH/HL/LH/LL, infers trend (uptrend/downtrend/range), and reports whether the latest bar broke the most recent swing as a Break of Structure (continuation) or Change of Character (reversal). left/ right set the pivot confirmation window.

Compute technical indicators for a symbol/timeframe.

indicators is a list of specs "name:param1,param2", e.g. ["rsi:14", "macd:12,26,9", "ema:20", "bbands:20,2", "supertrend:10,3", "stochrsi", "ichimoku"]. Pine-style aliases like "ta.rsi(14)" and "ta.ema(20)" are also accepted.

Supported (73):

• MAs/overlays: sma, ema, wma, smma, dema, tema, hma, vwma, zlema, alma, kama, trima, lsma, vidya, t3, vwap, vwapbands, bbands, donchian, keltner, supertrend, ichimoku, psar

• Momentum: rsi, stochrsi, macd, ppo, stoch, cci, willr, roc, mom, tsi, ao, cmo, uo, dpo, trix, coppock, kst, fisher, rvi, mfi, wavetrend, squeeze, qqe, crsi, stc, elderray, zscore, linregslope

• Volatility: atr, natr, stdev, hv, chop, ulcer, massindex

• Volume: obv, adl, cmf, chaikinosc, eom, fi, pvt, vo, klinger

• Trend: adx, dmi, aroon, vortex

• Structure: heikinashi, pivots

Returns each indicator's latest value(s) plus derived signals: RSI/MFI/ StochRSI/UO/CRSI/STC overbought-oversold state; MACD/PPO/WaveTrend/ QQE cross; zero-line cross for oscillators (ao/tsi/cmo/trix/ roc/mom/zscore); supertrend/psar direction & flip; squeeze on/off; dmi/heikinashi trend; ichimoku cloud signal. Set include_series=true for each indicator's primary time series. Pine aliases include ta.wt, ta.sqz, ta.ha.

Thorough, evidence-backed read of one symbol across multiple timeframes.

Returns, in a single call:

• per-timeframe trend (HH/HL structure, BOS/CHoCH) and momentum,

• statistical & market-state context (price percentile, ADX/efficiency trend state, ATR volatility state) so each value is interpretable,

• the historical forward-return distribution of the current divergence signal on this symbol/timeframe — a strictly causal event study,

• a synthesized verdict: bias, confidence, multi-timeframe agreement and explicit caveats.

Prefer this over the lighter compute_indicators / analyze_structure / detect_divergence when the user wants a thorough judgement, asks whether a setup is worth taking, or says "analyze X deeply". It is heavier (reads several timeframes + runs an event study), so use the single-shot tools for quick one-value questions.

timeframes defaults to a 1d/4h/1h ladder (highest -> execution). Read-only public market data; not financial advice.

Pine-style crossover analysis (ta.crossover/ta.crossunder).

series_a and series_b are each an indicator spec (ema:20, ta.sma(50)), a price source (close, hl2, …) or a numeric constant ("30"). Example: a golden cross is series_a="ema:50", series_b="ema:200". Returns the latest values, their relation, whether a cross happened on the last bar, and how many bars since the last cross.

Detect regular/hidden bullish & bearish divergence between price and an oscillator.

Compares the two most recent confirmed pivot highs (for bearish) and pivot lows (for bullish). oscillator is any indicator spec (rsi:14, macd:12,26,9, cci:20, mfi:14, …). left and right set the pivot confirmation window. Returns the detected divergences with their pivot price/oscillator values and bar offsets.

Detect candlestick patterns on the most recent lookback candles.

Recognizes doji (incl. dragonfly/gravestone), hammer/hanging man, inverted hammer/shooting star, marubozu, spinning top, bullish/bearish engulfing & harami, piercing line, dark cloud cover, tweezers, morning/ evening star, and three white soldiers/black crows. Each result carries its conventional bias (bullish/bearish/neutral) and bars_ago.

Find clustered support/resistance zones from swing pivots.

Groups pivot highs/lows that lie within tolerance_pct of each other into zones; each zone's touches is its strength. Returns the nearest support (below price) and resistance (above price) zones with their distance from the current price.

Aggregate a symbol's price across multiple exchanges (arbitrage view).

Fetches the ticker on each configured (or given) exchange concurrently and returns the 24h-volume-weighted average price, the simple mean, the cheapest/most-expensive venue, and the cross-exchange spread (arb_spread / arb_spread_pct) — the foundation for spotting arbitrage. Venues that fail or lack the symbol are skipped.

Get the current (and predicted) funding rate for a perpetual future.

Symbol should be a perpetual (e.g. BTC/USDT:USDT). Returns a structured error if the exchange does not support funding rates.

Get historical OHLCV candles (basis for charts and indicators).

Served from a DuckDB cache first, topping up only the missing tail via REST. timeframe accepts values like 1m,5m,15m,1h,4h,1d; since accepts ISO-8601 or epoch-ms. limit is capped at 1000.

Get the current order book snapshot with computed spread.

Returns top-depth bids/asks (capped at 100), spread and spread_pct, plus freshness fields. Uses the live WebSocket buffer when warm, otherwise REST.

Get the most recent executed trades (ticks) from the live buffer.

Falls back to a REST snapshot (and starts watching) when the buffer is cold. limit is capped at 1000.

Get the current price snapshot for a symbol (the primary quote tool).

Returns last/bid/ask, 24h high/low/volume, 24h change %, plus freshness fields source (websocket|rest), age_ms and timestamp. The first (cold) call answers via REST and starts a live WebSocket watch, so subsequent calls return fresher websocket-sourced data.

List currently active WebSocket subscriptions and their buffer state (diagnostic): channels, buffer size, last update and staleness.

List the exchanges this server is configured to use.

Returns the configured exchange ids and the default one used when a tool call omits the exchange argument.

List tradable symbols on an exchange, optionally filtered.

Use to discover valid symbols before other calls. quote filters by quote currency (e.g. USDT); search is a case-insensitive substring match (e.g. BTC).

Screen many symbols by indicator and price conditions.

filters is a list of conditions, each either indicator- or metric-based, e.g. [{"indicator":"rsi:14","op":"<","value":30}, {"metric":"change_24h_pct","op":">","value":5}]. op is one of < <= > >= == !=.

When symbols is omitted, the top top_n symbols by 24h volume for the given quote currency are screened. Runs with bounded concurrency to respect rate limits; per-symbol failures are returned in errors.

Health and diagnostics: uptime, exchanges, watch count, cache rows, ccxt version, and WebSocket reconnect count.

Pre-warm a live WebSocket subscription for a symbol (optional).

Most tools auto-watch on first use, so this is only needed to warm a buffer ahead of time. channels defaults to ["ticker","trades"]; valid channels are ticker, trades, orderbook, and ohlcv. For ohlcv, suffix the timeframe so the forming candle overlays your get_ohlcv queries on that timeframe — e.g. "ohlcv:1h" to enrich 1h candles (a bare "ohlcv" defaults to 1m and only overlays 1m queries). When the watch cap is exceeded, the least-recently-used symbol is released.