supertrend — Supertrend

Category: Trend · 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 trend indicator.

Parameters

Parameter	Type	Default
period	int	10
multiplier	float	3

Output columns

Column
supertrend
supertrend_dir

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
supertrend.reversal_up	event	Previous supertrend_dir=-1; current supertrend_dir=1. Initialization is not a reversal.	Reuses the ATR-channel state machine: a close below the final lower band reverses an up direction; a close above the final upper band reverses a down direction.	period + 2 contiguous bars with valid direction and active reference on both bars.
supertrend.reversal_down	event	Previous supertrend_dir=1; current supertrend_dir=-1. Initialization is not a reversal.	Reuses the ATR-channel state machine: a close below the final lower band reverses an up direction; a close above the final upper band reverses a down direction.	period + 2 contiguous bars with valid direction and active reference on both bars.

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": "supertrend", "params": {"period": 10, "multiplier": 3}}]
  }' \
  https://api.mobiusquant.ai/api/indicators

Full interpretation guide

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

supertrend (中文详情)

Related indicators

alligator · alma · ema · hma · hmm_regime · lsma · mcginley_dynamic · mobius_trend