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
  Copy 

Preview access

Free, Basic and Startup plans can test this endpoint with five successful requests per account per UTC day. Use the documented endpoint URL with your existing API key. Preview access is applied automatically. The allowance resets at 00:00 UTC.

All API keys, resource IDs, query parameters and pagination requests share this endpoint's allowance for your account. Failed requests do not consume the preview allowance. Successful previews also count toward your normal API usage, and your plan's result, historical-window and rate limits still apply. See endpoint previews for limits, response headers and quota errors.

Path parameters

Query parameters

Code examples

curl 'https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d&interval=hour&referenceCurrencyUuid=5k-_VTxqtCEI' \
  -H 'x-access-token: your-api-key' \
  -G

const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

fetch('https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d&interval=hour&referenceCurrencyUuid=5k-_VTxqtCEI', options)
  .then((response) => response.json())
  .then((result) => console.log(result));

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d&interval=hour&referenceCurrencyUuid=5k-_VTxqtCEI",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
      CURLOPT_HTTPHEADER => array(
        "x-access-token: your-api-key"
      ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

import requests

headers = {
  'x-access-token': 'your-api-key'
}

response = requests.request("GET", "https://api.coinranking.com/v2/indicators/Qwsogvtv82FCd/atr?timePeriod=7d&interval=hour&referenceCurrencyUuid=5k-_VTxqtCEI", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": [
    {
      "startingAt": 1774936800,
      "atr": "412.8371029163"
    },
    {
      "startingAt": 1774933200,
      "atr": "408.5192837465"
    }
  ]
}

Response fields

Error response

HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "COIN_NOT_FOUND",
  "message": "Coin not found"
}

Error responses