API Documentation

Digiconomist provides energy consumption and carbon footprint data on multiple crypto assets. Whereas the various energy consumption indices present annualized data, the Digiconomist API enables developers to quickly retrieve the total energy consumption and carbon footprint for the Bitcoin, Ethereum and Dogecoin networks on a specific date.

Additionally, the API also returns various metrics that can assist in determining the costs of an operation on a given network. The energy consumption indices present unweighted averages of the energy consumption and carbon footprints of transactions taking place on the respective networks. The Digiconomist API provides these metrics at a more granular level (considering transaction outputs or gas units depending on the network), to enable developers to determine a weighted footprint for their operations.

Note that data availability is limited to the launch data of the respective energy consumption index. The start date for each asset is listed below:

  • Bitcoin – February 10, 2017.
  • Ethereum – May 20, 2017.
  • Dogecoin – January 1, 2021.

Endpoints

  • https://digiconomist.net/wp-json/mo/v1/bitcoin/stats/$date
  • https://digiconomist.net/wp-json/mo/v1/ethereum/stats/$date
  • https://digiconomist.net/wp-json/mo/v1/dogecoin/stats/$date

$date must be specified as YYYYMMDD.

Bitcoin and Dogecoin output

  • 24hr_kWh – Total network energy consumption over 24 hours in kilowatt-hour (kWh).
  • 24hr_kgCO2 – Total network carbon footprint over 24 hours in kilograms of CO2 (kgCO2).
  • Output_kWh – Average energy consumed per transaction output in kilowatt-hour (kWh).
  • Output_kgCO2 – Carbon footprint per transaction output in kilograms of CO2 (kgCO2).

Note: the average per output is based on the total transaction outputs including change outputs.

Ethereum output

Rather than providing the average energy use and carbon footprint of a transaction output, the Ethereum data endpoint returns these metric per unit of gas.

  • 24hr_kWh – Total network energy consumption over 24 hours in kilowatt-hour (kWh).
  • 24hr_kgCO2 – Total network carbon footprint over 24 hours in kilograms of CO2 (kgCO2).
  • Gas_unit_Wh – Average energy consumed per unit of gas in watt-hour (Wh).
  • Gas_unit_gCO2 – Carbon footprint per unit of gas in grams of CO2 (gCO2).

Example output

https://digiconomist.net/wp-json/mo/v1/bitcoin/stats/20220718:

{ "24hr_kWh":"365049263", "24hr_kgCO2":"203609877", "Output_kWh":"459.809", "Output_kgCO2":"256.463" }

https://digiconomist.net/wp-json/mo/v1/ethereum/stats/20220718:

{ "24hr_kWh":"213712536", "24hr_kgCO2":"119200304", "Gas_unit_Wh":"2.14436", "Gas_unit_gCO2":"1.19604" }

https://digiconomist.net/wp-json/mo/v1/dogecoin/stats/20220718:

{ "24hr_kWh":"9022879", "24hr_kgCO2":"5032601", "Output_kWh":"54.1463", "Output_kgCO2":"30.2006" }