CryptUnit API beta

Version 1.1 April 20, 2018

APIs are accessible via GET, and the parameters for the request are included in the query string.

Version 1.0 (August 4, 2018) - Initial Release
Version 1.1 (April 20, 2019) - Added Historical data endpoint

License

You can use our API under a Creative Commons Attribution 4.0 International (CC BY 4.0) license. Please credit us with a link (or consider using our logo) if you use our API on your website or app. NOTE: All our data is provided for free, and as-is without any warranty.

Rate limits

Request limit: 600/day. Please do not abuse API, a request every 3-5min should be more than enough. The data is refreshed every 10 minutes. (10, 20 ,30 ...). Historical data refreshes at the end of the day!

Responses

Responses are in JSON.

API Endpoints

Coins list

This endpoint displays all active coins in one call.

Endpoint: /api/coins
Example: /api/coins

Result:
[
  {
    "id": 24,
    "name": "Aeon",
    "ticker": "AEON",
    "logo": "https://www.cryptunit.com/coinicons/24.png",
    "algo_id": 4,
    "cryptunit_color": "#364b66"
  },
  {
    "id": 5,
    "name": "Monero",
    "ticker": "XMR",
    "logo": "https://www.cryptunit.com/coinicons/5.png",
    "algo_id": 3,
    "cryptunit_color": "#bd6c37"
  },
   ...
]
						  

Historical data

This endpoint displays historical: hashrate (Mh/s), diff, avg block reward & algo.

Endpoint: /api/history/?{coin_id}
Example: /api/history/?5 Monero (XMR) historical data
Example: /api/history/?20 Turtlecoin (TRTL) historical data

Required parameters
  • (int) coin_id - pass the coin ID (can be obtained from /api/coins)
Result:
[
  {
    "id": 5,
    "name": "Monero",
    "ticker": "XMR",
    "history": {
      "2018-02-06": {
        "hashrate": 809.8140533194,
        "difficulty": 97177686398,
        "reward": 5.38,
        "algo_id": 1
      },
      "2018-02-07": {
        "hashrate": 817.5895301531,
        "difficulty": 98110743618,
        "reward": 5.38,
        "algo_id": 1
      },
	  
	  ...
	  
      "2019-04-19": {
        "hashrate": 315.15888357381,
        "difficulty": 37819066029,
        "reward": 2.9,
        "algo_id": 25
      }	  
]
						  

Algos list

This endpoint displays all algos in one call.

Endpoint: /api/algos
Example: /api/algos

Result:
[
  {
    "id": 1,
    "name": "Cryptonight",
    "shortname": "normal",
    "shortname1": "CN",
    "asic": 1
  },
  {
    "id": 3,
    "name": "Cryptonight V7",
    "shortname": "normalV7",
    "shortname1": "CN V7",
    "asic": 0
  },
  ...
]
						  

Pools list

This endpoint displays all active mining pools collected by Cryptunit, for some coin.

Endpoint: /api/pools/?{id}
Example: /api/pools/?5
Required parameters
  • (int) id - pass the coin ID (can be obtained from /api/coins)
Result:
[
  {
	"id": 5,
    "name": "Semipool",
    "url": "https://xmr.semipool.com/",
    "checked": "2018-08-05 08:12:16",
    "curlstatus": 0
  },
  {
    "id": 127,
	"name": "Poolto.be",
    "url": "https://xmr.poolto.be/",
    "checked": "2018-08-05 08:12:16",
    "curlstatus": 0
  },
   ...
]
						  

Earnings - auto (auto calculated hashrate for all algos)

This endpoint displays all coins ordered by revenue. The automatic hashrate calculation for different algorithms is based on the Vega56 (samsung and hynix). The CPU calculation was based on AMD Ryzen T 1950X. Asic reference - Baikal Giant N.

Endpoint: /api/earnings
Optional parameters
  • (int) hashrate - in h/s. If not set - 10000 will be used.
  • (string) device - GPU, CPU or ASIC. If not set - GPU will be used.
  • (string) dataavg - live, 1h, 3h, 6h, 12h or 24h. If not set - 24h average will be used.
  • (int) algofilter - Filter by algo. ID can be obtained from /api/algos. If not set - all algos will be shown. You can also set more than one algo (comma delimited): 1,4,7...
  • (int) volumefilter - .1, .5, 1, 3, 5, 10. Filter coins by 24h BTC trading volume (trading volume > volumefilter). If not set > .1 will be used.
Examples:
/api/earnings
/api/earnings/?hashrate=5000&device=CPU
/api/earnings/?hashrate=100000&device=ASIC
/api/earnings/?hashrate=5000&device=CPU&dataavg=1h
/api/earnings/?hashrate=5000&device=CPU&algofilter=3
/api/earnings/?hashrate=5000&volumefilter=.5

Result:
[
  {
    "hashrate": 10000,
    "hashrate_auto": true,
    "device": "GPU",
    "algofilter": "",
    "volumefilter": 0.1,
    "dataavg": "24h",
    "updatetime": "2018-08-07 15:10:24",
    "coins": [
       {
        "coin_id": 23,
        "coin_name": "Intense",
        "coin_ticker": "ITNS",
        "algo_id": 3,
        "algo_name": "Cryptonight V7",
        "algo_asic": false,
        "hashrate_auto": 10000,
        "hashrate_manual": null,
        "reward_day_usd": 7.9391228927918,
        "reward_month_usd": 238.17368678375,
        "reward_day_coins": 2650.7676885528,
        "reward_month_coins": 79523.030656583,
        "volume_24h_usd": 10336.724320761
      },
      {
        "coin_id": 21,
        "coin_name": "Masari",
        "coin_ticker": "MSR",
        "algo_id": 7,
        "algo_name": "Cryptonight Fast",
        "algo_asic": false,
        "hashrate_auto": 19000,
        "hashrate_manual": null,
        "reward_day_usd": 7.870526668406,
        "reward_month_usd": 236.11580005218,
        "reward_day_coins": 26.918031548732,
        "reward_month_coins": 807.54094646197,
        "volume_24h_usd": 12609.182318711
      },
      ...
    ]
  }
]
						  

Earnings - custom (set custom hashrate for algos)

This endpoint displays all coins ordered by revenue. Set custom hashrate for algo, or multiple algos.

Endpoint: /api/earningscustom
At least one parameter is required
Optional parameters
  • (string) dataavg - live, 1h, 3h, 6h, 12h or 24h. If not set - 24h average will be used.
  • (int) volumefilter - .1, .5, 1, 3, 5, 10. Filter coins by 24h BTC trading volume (trading volume > volumefilter). If not set > .1 will be used.
Examples:
/api/earningscustom/?hashrate[3]=10000
/api/earningscustom/?hashrate[3]=10000&hashrate[4]=20000
/api/earningscustom/?hashrate[3]=10000&hashrate[4]=20000&volumefilter=5
/api/earningscustom/?hashrate[3]=10000&dataavg=1h

Result:
[
    {
        "hashrate_auto": false,
        "device": "CUSTOM",
        "algofilter": [
            3,
            4
        ],
        "volumefilter": ".1",
        "dataavg": "24h",
        "updatetime": "2018-08-08 10:28:20",
        "coins": [
            {
                "coin_id": "5",
                "coin_name": "Monero",
                "coin_ticker": "XMR",
                "algo_id": "3",
                "algo_name": "Cryptonight V7",
                "algo_asic": false,
                "hashrate_auto": null,
                "hashrate_manual": 10000,
                "reward_day_usd": 7.4442364430089,
                "reward_month_usd": 223.32709329027,
                "reward_day_coins": 0.067357762741957,
                "reward_month_coins": 2.0207328822587,
                "volume_24h_usd": "20078880.9014870000"
            },
            {
                "coin_id": "20",
                "coin_name": "TurtleCoin",
                "coin_ticker": "TRTL",
                "algo_id": "4",
                "algo_name": "Cryptonight Lite V7",
                "algo_asic": false,
                "hashrate_auto": null,
                "hashrate_manual": 20000,
                "reward_day_usd": 6.894888792794,
                "reward_month_usd": 206.84666378382,
                "reward_day_coins": 167899.05381574,
                "reward_month_coins": 5036971.6144721,
                "volume_24h_usd": "8852.7821900133"
            },
           ...
        ]
    }
]