donchian_channels — Donchian Channels

Category: Volatility · Standard

Reading the response

Use POST /api/indicators?explain=true to include interpretation notes at indicators[responseKey].explain. Read numeric results from columns and data in the same object.

This is a volatility indicator.

Parameters

Parameter	Type	Default
length	int	20

Output columns

Column
dc_basis
dc_lower
dc_upper

Native features

Set top-level signals: true and read indicators[responseKey].signals. By default features are evaluated on closed bars: true is a positive result, false a valid negative result, and null unknown. These are not trade instructions.

This indicator supports include_forming: true: treat the current final OHLCV sample as complete under the same native rules, returning one set of values, features and objects. The signal table appends bar_status: closed for closed bars, forming for a trial with confirmed_at_ms=null. A trial may disappear on later updates or at close. For BYO, still set last_bar_closed: false. Close requirements below describe the default mode; trials only admit the final sample without shortening structural windows or model confirmation requirements. See forming trials.

History lengths are minimum evaluation requirements, not convergence guarantees. Comparisons use unrounded values and the exact boundaries below. Do not turn null into false on gaps, invalid dependencies or forming bars in the default mode.

Feature column	Kind	Rule	Meaning	History / validity
donchian_channels.breakout_up	event	Current close > previous dc_upper.	The close breaks the preceding completed window, excluding the current bar. Consecutive new extremes may trigger on consecutive bars.	length + 1 contiguous bars and a valid preceding channel.
donchian_channels.breakout_down	event	Current close < previous dc_lower.	The close breaks the preceding completed window, excluding the current bar. Consecutive new extremes may trigger on consecutive bars.	length + 1 contiguous bars and a valid preceding channel.

See feature requests for the format and examples. /api/chart also accepts signals: true, marking confirmed events by default. With include_forming, trial events also produce markers tagged bar_status=forming; states are not drawn on every bar. See feature charts.

Example call

curl -X POST -H "Authorization: Bearer mq_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "exchange": "binance",
    "market":   "perp",
    "symbol":   "BTCUSDT",
    "interval": "5m",
    "limit":    100,
    "signals":  true,
    "calc":     [{"name": "donchian_channels", "params": {"length": 20}}]
  }' \
  https://api.mobiusquant.ai/api/indicators

Full interpretation guide

Field meanings, interpretation rules and usage notes are documented in Chinese at:

donchian_channels (中文详情)

Related indicators

atr · bollinger · chande_kroll_stop · fibonacci_bollinger_bands · historical_volatility · keltner_channels · linear_regression_channel · mass_index