Get coin ATR
Get the Average True Range (ATR) for a coin throughout time. The ATR measures volatility: it is the average height of a candle, counting any gap from the previous candle's close as part of that height. A rising ATR means the coin is moving further per candle than it was, in either direction — the ATR says nothing about which way.
The period is 14 candles, and a candle is one bucket of the interval you request — so interval=day gives the familiar 14-day ATR, while interval=hour gives a 14-hour one.
The ATR is a price, not a percentage. It is denominated in whatever referenceCurrencyUuid you request, so an ATR of 412 on Bitcoin in US Dollars means the average candle spans about $412. Comparing volatility between two coins therefore means dividing by their prices yourself — a $412 range on a $100,000 coin is a much quieter market than a $412 range on a $2,000 one.
This uses Wilder's smoothing, the original definition, rather than a plain mean of the last 14 ranges. Every value therefore depends on the one before it, and we read a long run of earlier candles before the first one we return so that the series has converged by the time you see it. That is also why the first returned candle already carries a value rather than starting blank.
https://api.coinranking.com/v2/indicators/:uuid/atr
Path parameters
| Parameter | Description |
|---|---|
uuid String | UUID of the coin you want to request the ATR for. |
Query parameters
| Parameter | Description | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
timePeriod (optional) String |
The time period for which the ATR data is returned. The number of data points and the default interval are determined by the time period. Default value: 24hAllowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y 10y all Example:
https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d
|
||||||||||||||||||||||||||
interval (optional) String |
The interval determines the granularity of each data point, and therefore what one ATR period means. If not provided, a default interval is used based on the selected timePeriod. Only certain intervals are available per timePeriod — see the table below.
Example:
https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d&interval=day
|
||||||||||||||||||||||||||
referenceCurrencyUuid (optional) String |
UUID of coin (either fiat or crypto), in whose terms the price is measured before the ATR is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint The returned Example:
https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?referenceCurrencyUuid=5k-_VTxqtCEI
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": [
{
"startingAt": 1774936800,
"atr": "412.8371029163"
},
{
"startingAt": 1774933200,
"atr": "408.5192837465"
}
]
}
Response fields
| Property | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object[] | List of ATR data points, newest first |
data.startingAt Number | An Epoch startingAt in seconds marking the start of the time period. |
data.atr String | The 14-period Average True Range over the last 14 candles of the requested |
Error response
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next