Standard Deviation
The standard deviation technical indicator is a statistical measure that quantifies the dispersion of a set of data points from its mean (average). In the context of financial markets, it is often used to assess the volatility or variability of price movements.
Customize the Standard Deviation
You can personalize the calculation of the standard deviation indicator in two ways. Firstly, you can adjust the period parameter, which dictates the number of candles or periods considered in the calculation. A shorter period captures more recent price action, making the indicator more sensitive to changes in volatility, while a longer period smooths out fluctuations and provides a broader view. Secondly, the optInNbDev parameter acts as a multiplier and defaults to 1, but you can tweak it to increase or decrease the sensitivity of the indicator to volatility. A higher multiplier widens the standard deviation bands, indicating greater volatility, while a lower multiplier narrows the bands, suggesting lower volatility. By customizing these parameters, you can tailor the indicator to your specific trading strategies and preferences.
Get stddev values via API
We provide API access to the Standard Deviation values for all of the most popular assets like stocks, crypto (try one of the popular exchanges like Binance) and forex, on all commonly used timeframes – from the weekly and daily all the way down to one minute intervals. You can also calculate the values on your own data using our manual method.
Get started with the stddev
Simply make an HTTPS [GET] request or call in your browser:
[GET] https://api.taapi.io/stddev?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=1h
API response
The stddev endpoint returns a JSON response like this:
{
"value": 235.08268735915223
}
Example response from TAAPI.IO when querying stddev endpoint.
API parameters
binance, binancefutures or one of our supported exchanges. For other crypto / stock exchanges, please refer to our Client or Manual integration methods.
BTC/USDT Bitcoin to Tether, or LTC/BTC Litecoin to Bitcoin...
1m, 5m, 15m, 30m, 1h, 2h, 4h, 12h, 1d, 1w. So if you're interested in values on hourly candles, use interval=1h, for daily values use interval=1d, etc.
backtrack parameter removes candles from the data set and calculates the stddev value X amount of candles back. So, if you’re fetching the stddev on the hourly and you want to know what the stddev was 5 hours ago, set backtrack=5. The default is 0 and a maximum is 50.
backtracks parameter returns the stddev value calculated on every candle for the past X candles. For example, if you want to know what the stddev was every hour for the past 12 hours, you use backtracks=12. As a result, you will get 12 values back.
chart parameter accepts one of two values: candles or heikinashi. candles is the default, but if you set this to heikinashi, the indicator values will be calculated using Heikin Ashi candles. Note: Pro & Expert Plans only.
true or false. Defaults to false. By setting to true the API will return a timestamp with every result (real-time and backtracked) to which candle the value corresponds. This is helpful when requesting multiple backtracks.
true or false. Defaults to true. By setting to false, the API will ensure that there are no candles missing. This often happens on lower timeframes in thin markets. Gaps will be filled by a new candle with 0 volume, and OHLC set the the close price of the latest candle with volume.
number or max. Use this parameter to access historical values on the past X candles until the most recent candle. Use max to return all available historical values. Returns an array with the oldest value on top and most recent value returned the last.
Number of candles included in the calculation. Similar to the “length” parameter on Trading View.
Default: 5
Desired level of deviation, working as a multiplier.
Default: 1
More examples
Let's say you want to know the stddev value on the last closed candle on the 30m timeframe. You are not interest in the real-time value, so you use the backtrack=1 optional parameter to go back 1 candle in history to the last closed candle.
[GET] https://api.taapi.io/stddev?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=30m&backtrack=1
Get stddev values on each of the past X candles in one call
Let's say you want to know what the stddev daily value was each day for the previous 10 days. You can get this returned by our API easily and efficiently in one call using the backtracks=10 parameter:
[GET] https://api.taapi.io/stddev?secret=MY_SECRET&exchange=binance&symbol=BTC/USDT&interval=1d&backtracks=10
Here's the example response:
[
{
"value": 235.08268735915223,
"backtrack": 0
},
{
"value": 490.25858734345456,
"backtrack": 1
},
{
"value": 572.6147648602853,
"backtrack": 2
},
{
"value": 501.19714438931004,
"backtrack": 3
},
{
"value": 333.02451125404986,
"backtrack": 4
},
{
"value": 186.25396156860654,
"backtrack": 5
},
{
"value": 186.12806361212694,
"backtrack": 6
},
{
"value": 248.27093695396624,
"backtrack": 7
},
{
"value": 299.9312348789302,
"backtrack": 8
},
{
"value": 355.5748984053851,
"backtrack": 9
}
]
Looking for even more integration examples in different languages like NodeJS, PHP, Python, Curl or Ruby? Continue to [GET] REST - Direct documentation.