Indicators›Trend›SuperTrend
GET/indicator/supertrend

SuperTrend

Category: Trend · Updated November 2026


The TAAPI.IO SuperTrend API returns the SuperTrend line and its direction as JSON for crypto pairs and US stocks. Send an exchange, symbol and timeframe to get real-time or historical values, with no candles to download and no calculations to maintain.

What one request returns

  • The line (value): a price below the market in an uptrend and above it in a downtrend. Many traders use it as a trailing stop.
  • The direction (valueAdvice): long or short. When it changes from one candle to the next, the trend has flipped.
  • A series or several timeframes, with results and /bulk: for example a 4-hour SuperTrend for entries and a daily SuperTrend for the trend, in one request.

So one call answers two questions: which way is the trend, and where would you get out?

Example: four whipsaws and one long short, 7 October to 14 November 2026

Request: one /bulk call for ETHUSDT on Binance, with SuperTrend on 4-hour candles (results=2, backtrack=1, so the last two closed candles) and on daily candles (backtrack=1, so yesterday). Sent at 21:55 UTC on 14 November with the default settings of 7 and 3.

CandleETH closeLineAdviceReading
4h, 14 Nov 12:001,841.232,014.42shortLine above price: downtrend
4h, 14 Nov 16:001,835.091,980.20shortNo flip. The line moved down, so the stop tightened
1d, 13 Nov1,929.882,265.73shortThe daily trend agrees

How to interpret this: The 4-hour SuperTrend has been short since 5 November at 12:00, when ETH closed at 2,252.70. Since then ETH has fallen 18.5%, and the line has followed it down from 2,506.60 to 1,980.20. A short opened at that flip and closed at the line would now keep at least 12.1% of the move, even if ETH turned straight back up. That one leg is the reason traders use SuperTrend, but it came after four losing flips. ETH flipped seven times on the 4-hour chart since 7 October. The three long flips each reversed within two days, for losses of 4.6%, 3.3% and 3.2%. In between, short legs made 1.8% and 2.5% and lost 0.9%. All three long flips came while the daily SuperTrend was short, which it has been since 8 October. A trend-following bot that only took 4-hour flips in the daily direction would have skipped all three longs, and with them 11.1% of losses.

ETHUSDT 4-hour candles and SuperTrend 7, 3, 19 October to 14 November 2026 SuperTrend flipped four times. The two long flips on 21 October and 4 November reversed within two days for losses of 3.3% and 3.2%. The short flip on 5 November at 2,252.70 has held for 55 candles while ETH fell to 1,835, a move of 18.5%. 1,800 1,900 2,000 2,100 2,200 2,300 2,400 2,500 2,600 20 Oct 24 Oct 28 Oct 1 Nov 5 Nov 9 Nov 13 Nov Long 2,469: −3.3% Short 2,387: +2.5% Long 2,328: −3.2% Short 2,253, still open: +18.5% Stop now 1,980.20, 7.9% above the close Long Short Flip to long Flip to short ETHUSDT · Binance 4h candles · SuperTrend 7, 3 · 19 Oct – 14 Nov 2026 (closed candles)
4-hour candles with SuperTrend 7, 3. The line is green while the advice is long and red while it is short. Triangles mark each flip. Both long flips in this period reversed within two days.
FlipAdviceETH closeNext flipResultDaily trend
7 Oct 00:00short2,611.1412 Oct 04:00+1.8%long until 8 Oct
12 Oct 04:00long2,564.1912 Oct 20:00−4.6%short
12 Oct 20:00short2,447.1721 Oct 08:00−0.9%short
21 Oct 08:00long2,469.3722 Oct 16:00−3.3%short
22 Oct 16:00short2,387.204 Nov 08:00+2.5%short
4 Nov 08:00long2,327.965 Nov 12:00−3.2%short
5 Nov 12:00short2,252.70still open+18.5%short

Values are from the production API on 14 November 2026, using closed 4-hour candles. Results compare the close at one flip with the close at the next, with no fees. Seven flips are an illustration, not a backtest, and nothing here is financial advice.

SpecValue
EndpointGET https://v2.taapi.io/indicator/supertrend
OutputsLine value, advice (long or short), timestamp
Default settingsPeriod 7, multiplier 3
MarketsBinance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes1m to 1w
DeliveryREST, bulk and WebSocket

Get SuperTrend with one API call

This request returns SuperTrend for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.

curl -G https://v2.taapi.io/indicator/supertrend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h"

SuperTrend API response

Every value is returned in an array, even for a single candle. This response came from the live API on 9 November 2026.

200 OK
{
  "value": [75832.37560889388],
  "valueAdvice": ["short"],
  "timestamp": [1794218400]
}
FieldTypeDescription
valuenumber[]The SuperTrend line: below price when long, above price when short
valueAdvicestring[]long or short
timestampinteger[]Unix time of each candle, in seconds

SuperTrend API parameters

NameTypeRequiredDefaultDescription
exchangestringYes—binance, binancefutures, bybit, gateio, kraken or stocks
symbolstringYes—Pair or ticker, e.g. BTCUSDT or AAPL
timeframestringYes—1m 5m 15m 1h 4h 1d 1w
periodintegerNo7ATR period
multipliernumberNo3ATR multiple between the candle midpoint and the line, e.g. 2.5
resultsintegerNo1Number of values to return, or max
backtrackintegerNo0Candles to skip from the most recent

What is SuperTrend?

SuperTrend is a trailing line built from the Average True Range (ATR). It sits below price in an uptrend and above price in a downtrend, and flips when a candle closes through it. It is popular because it reduces a trend to one line and one state.

SuperTrend formula

StepCalculation
Basic upper band(high + low) ÷ 2 + multiplier × ATR(period)
Basic lower band(high + low) ÷ 2 − multiplier × ATR(period)
Final upper bandThe basic upper band if it is lower than the previous final upper band, or if the previous close was above it. Otherwise the previous final upper band
Final lower bandThe basic lower band if it is higher than the previous final lower band, or if the previous close was below it. Otherwise the previous final lower band
DirectionFlips to long when the close goes above the final upper band, and to short when it goes below the final lower band
SuperTrendThe final lower band while long, the final upper band while short

ATR uses Wilder's smoothing. In the example above, the 14 November 16:00 candle had a high of 1,858.25 and a low of 1,811.29, so its midpoint was 1,834.77. With a 7-period ATR of 48.48, the basic upper band is 1,834.77 + 3 × 48.48 = 1,980.20. That is lower than the previous line of 2,014.42, so the line moved down to it.

How to read SuperTrend in your code

SignalMeaningCondition
UptrendLine below pricevalueAdvice is long
DowntrendLine above pricevalueAdvice is short
FlipTrend changed on this candlevalueAdvice differs from the previous candle
Trailing stopExit level for the current trendvalue
Stop distanceHow much a reversal would give backGap between the close and value, as a percentage of the close

Limitations: SuperTrend flips repeatedly in sideways markets, and after a volatile move the line can be far from price. In the example the stop was 7.9% above the close. Nothing on this page is financial advice.

How SuperTrend works

SuperTrend starts from the middle of each candle and adds or subtracts a multiple of ATR, producing an upper and a lower band. Only one is active at a time: the lower band during an uptrend and the upper band during a downtrend.

The active band can only tighten. In a downtrend the line can fall or stay flat but never rise, which is why it works as a trailing stop. In the example it stayed flat at 2,159.03 for nine candles between 10 and 12 November while ETH moved sideways, then started falling again with price. When a candle closes through the line, the direction flips and the opposite band takes over.

Choosing the period and multiplier

The multiplier has the larger effect. A smaller value keeps the line close to price, which gives earlier exits and more flips. A larger value gives moves more room but gives back more profit before it reacts.

The period sets how quickly the ATR adapts. SuperTrend works best in sustained trends and struggles in sideways markets, so a higher-timeframe filter, as below, or a trend-strength filter such as ADX can cut the number of flips. Backtest the settings on your own market, using results to fetch a series.

Detect a SuperTrend flip with Python

valueAdvice is long or short. A flip is the moment it changes between the last two closed candles.

curl -G https://v2.taapi.io/indicator/supertrend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=2" \
  --data-urlencode "backtrack=1"

Filter flips with the daily trend

On short timeframes most flips against the bigger trend fail quickly, as the three long flips in the example did. A common fix is to take a 4-hour flip only when the daily SuperTrend points the same way, or a 15-minute flip only when the 1-hour SuperTrend agrees. One /bulk request returns both. Two constructs need the Pro plan or above. On Basic, make two GET requests instead.

POST/bulk
curl -X POST https://v2.taapi.io/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "constructs": [
    {
      "id": "eth_4h",
      "exchange": "binance",
      "symbol": "ETHUSDT",
      "timeframe": "4h",
      "indicators": [
        {
          "id": "supertrend",
          "indicator": "supertrend",
          "results": 2,
          "backtrack": 1
        }
      ]
    },
    {
      "id": "eth_1d",
      "exchange": "binance",
      "symbol": "ETHUSDT",
      "timeframe": "1d",
      "indicators": [
        {
          "id": "supertrend",
          "indicator": "supertrend",
          "backtrack": 1
        }
      ]
    }
  ]
}'

The response at 21:55 UTC on 14 November. Both 4-hour candles are short, so there is no flip, and the script prints Still short (daily short), stop at 1980.20. Run at 12:05 UTC on 4 November, just after the 08:00 candle closed, the same script would have printed 4h flip to long against the daily trend: skip. Run it once per closed candle so you don't miss a flip.

200 OK
{
  "eth_4h": {
    "supertrend": {
      "value": [2014.4168386559516, 1980.1987188479584],
      "valueAdvice": ["short", "short"],
      "timestamp": [1794657600, 1794672000]
    }
  },
  "eth_1d": {
    "supertrend": {
      "value": [2265.725376093564],
      "valueAdvice": ["short"],
      "timestamp": [1794528000]
    }
  }
}

With this filter, the only 4-hour flips taken since 8 October were the three shorts: −0.9%, +2.5% and the open +18.5%. The filter still lets through a losing trade, as on 12 October, and it reacts late to a real change of trend, because the daily line is far from price: it was 2,265.73 on 13 November, 17% above the close. Other common filters: require ADX above 20, or check that price is on the same side of a 200-period EMA.

Get historical SuperTrend values

Add results to return a series for backtesting or charting. The last element is the most recent candle.

curl -G https://v2.taapi.io/indicator/supertrend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get SuperTrend for multiple symbols

Combine SuperTrend with other indicators in one request. Each exchange, symbol and timeframe combination is one construct: Basic allows 1 per request, Pro 3 and Expert 10.

POST/bulk
curl -X POST https://v2.taapi.io/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "constructs": [
    {
      "id": "btc_1h",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "timeframe": "1h",
      "indicators": [
        {
          "id": "supertrend",
          "indicator": "supertrend"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream SuperTrend in real time

Subscribe over WebSocket to receive new values every 5 seconds while the candle is forming. Streaming supports 1m, 5m, 15m and 1h, and uses interval where REST uses timeframe.

WSSwss://v2.taapi.io/streaming
{
  "type": "subscribe",
  "id": "supertrend",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "supertrend"
}

Common SuperTrend settings

These are starting points, not recommendations. Test any setting on your own market and timeframe.

SettingsCharacterTypical use
7, 3API defaultGeneral use
10, 3Common alternativeThe default on many charting platforms
10, 2TighterMore flips, closer stops
10, 4LooserFewer flips, more room in volatile markets

Why SuperTrend values can differ between platforms

  • Default settings: The API default is 7 and 3. Many charts default to 10 and 3.
  • ATR method: TAAPI.IO uses Wilder's smoothed ATR. Some platforms use a simple average of the true range, which moves the line.
  • Starting point: The line depends on where the calculation starts, so platforms that load a different amount of history can disagree for a while after a flip.
  • Open candle: The advice can change on the forming candle. Use backtrack=1 to act only on closes.

SuperTrend API FAQ

What does the SuperTrend API return?

Three arrays: value with the line, valueAdvice with long or short, and a timestamp for each candle.

Is the latest SuperTrend value final?

No. The newest value belongs to the candle still forming, and the advice can flip and flip back before it closes. Add backtrack=1 to read the last closed candle.

How do I detect a SuperTrend flip?

Request results=2 with backtrack=1 and compare the two valueAdvice values. If they differ, the trend flipped on the last closed candle.

Can I use SuperTrend as a stop-loss?

Many traders do: value is the level where the trend would flip. Check the distance first. After a sharp move the line can be several percent away, as in the example above.

Which SuperTrend settings can I change?

You can set period and multiplier. The defaults are 7 and 3, and the multiplier accepts decimals such as 2.5.

Can I get SuperTrend for US stocks?

Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.

Build with SuperTrend on Binance, Bybit or US stocks. Start for free or browse all 262 indicators.