Project Debt

Search, sort, and filter for projects that have carbon debt.

Fetch the carbon debt of different projects

GET https://api.dovu.earth/api/market/contracts

This endpoint allows you to sort, filter, and paginate on the carbon debt of all active projects, initially focusing on the Ethereum ecosystem.

Query Parameters

Name	Type	Description
filter	string	Filter for a given project using the name or ticker of the token.
page	number	Paginate the returned results.
limit	number	Describe a limit to return, defaults to 100.
sortby	string	Sort the results by one of the column rows.
sortdir	string	Defaults to ascending (asc) but can to descending (desc).

200 Example of the top 3 projects with the largest carbon debt.

{
  "data": [
    {
      "id": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "name": "Tether",
      "type": "ERC20",
      "symbol": "USDT",
      "website": "https://tether.to",
      "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar.",
      "gas_used": 4608416876278,
      "twitter_handle": "Tether_to",
      "transactions_count": 107598526,
      "rank": 1,
      "total_carbon_debt": 1324455848.4074783,
      "cost_to_offset": 84765174.29807861,
      "dov_to_offset": 5169995260.806474,
      "daily_aggregates": [
        {
          "date": "2021-07-31 00:00:00",
          "gas_used": 4676384996,
          "total_gas": 4580686028031,
          "day_change": -928729476,
          "percent_day_change": -16.57,
          "week_change": 7121716879,
          "percent_week_change": 20.59,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-01 00:00:00",
          "gas_used": 4283582417,
          "total_gas": 4584969610448,
          "day_change": -392802579,
          "percent_day_change": -8.4,
          "week_change": 6719465358,
          "percent_week_change": 19.35,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-02 00:00:00",
          "gas_used": 5856374916,
          "total_gas": 4590825985364,
          "day_change": 1572792499,
          "percent_day_change": 36.72,
          "week_change": 8643876538,
          "percent_week_change": 24.98,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-03 00:00:00",
          "gas_used": 5156010497,
          "total_gas": 4595981995861,
          "day_change": -700364419,
          "percent_day_change": -11.96,
          "week_change": 7464179608,
          "percent_week_change": 21.28,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-04 00:00:00",
          "gas_used": 5238932942,
          "total_gas": 4601220928803,
          "day_change": 82922445,
          "percent_day_change": 1.6099999999999999,
          "week_change": 7545821197,
          "percent_week_change": 21.65,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-05 00:00:00",
          "gas_used": 4404267746,
          "total_gas": 4605625196549,
          "day_change": -834665196,
          "percent_day_change": -15.93,
          "week_change": 6584963161,
          "percent_week_change": 18.89,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        },
        {
          "date": "2021-08-06 00:00:00",
          "gas_used": 2791679729,
          "total_gas": 4608416876278,
          "day_change": -1612588017,
          "percent_day_change": -36.61,
          "week_change": 1739010466,
          "percent_week_change": 4.79,
          "ethereum_contract_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
        }
      ]
    },
    {
      "id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "name": "USD Coin",
      "type": "ERC20",
      "symbol": "USDC",
      "website": "https://centre.io/usdc",
      "description": "USDC is a fully collateralized US dollar stablecoin, an Ethereum powered coin and is the brainchild of CENTRE, an open source project bootstrapped by contributions from Circle and Coinbase.",
      "gas_used": 598637115262,
      "twitter_handle": null,
      "transactions_count": 12571173,
      "rank": 2,
      "total_carbon_debt": 172047896.20137402,
      "cost_to_offset": 11011065.356887937,
      "dov_to_offset": 671586605.9728181,
      "daily_aggregates": [
        {
          "date": "2021-07-31 00:00:00",
          "gas_used": 1478163525,
          "total_gas": 590264026267,
          "day_change": -189071675,
          "percent_day_change": -11.34,
          "week_change": 2137284620,
          "percent_week_change": 19.72,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-01 00:00:00",
          "gas_used": 1231670772,
          "total_gas": 591495697039,
          "day_change": -246492753,
          "percent_day_change": -16.68,
          "week_change": 2000779656,
          "percent_week_change": 18.43,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-02 00:00:00",
          "gas_used": 1580487819,
          "total_gas": 593076184858,
          "day_change": 348817047,
          "percent_day_change": 28.32,
          "week_change": 2415464071,
          "percent_week_change": 22.21,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-03 00:00:00",
          "gas_used": 1585996050,
          "total_gas": 594662180908,
          "day_change": 5508231,
          "percent_day_change": 0.35,
          "week_change": 1817554945,
          "percent_week_change": 16.34,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-04 00:00:00",
          "gas_used": 1747338593,
          "total_gas": 596409519501,
          "day_change": 161342543,
          "percent_day_change": 10.17,
          "week_change": 1499277285,
          "percent_week_change": 13.4,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-05 00:00:00",
          "gas_used": 1443074523,
          "total_gas": 597852594024,
          "day_change": -304264070,
          "percent_day_change": -17.41,
          "week_change": 1124195947,
          "percent_week_change": 10.01,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        {
          "date": "2021-08-06 00:00:00",
          "gas_used": 784521238,
          "total_gas": 598637115262,
          "day_change": -658553285,
          "percent_day_change": -45.64,
          "week_change": 188953915,
          "percent_week_change": 1.67,
          "ethereum_contract_id": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        }
      ]
    },
    {
      "id": "0x0000000000b3F879cb30FE243b4Dfee438691c04",
      "name": "Gastoken",
      "type": "ERC20",
      "symbol": "GST2",
      "website": "",
      "description": "-",
      "gas_used": 215826601500,
      "twitter_handle": null,
      "transactions_count": 280827,
      "rank": 3,
      "total_carbon_debt": 62028417.19246871,
      "cost_to_offset": 3969818.7003179975,
      "dov_to_offset": 242127076.79609147,
      "daily_aggregates": [
        {
          "date": "2021-07-31 00:00:00",
          "gas_used": 291618,
          "total_gas": 215824548433,
          "day_change": -3570479,
          "percent_day_change": -92.45,
          "week_change": 3019661,
          "percent_week_change": 143.35,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        },
        {
          "date": "2021-08-01 00:00:00",
          "gas_used": 640111,
          "total_gas": 215825188544,
          "day_change": 348493,
          "percent_day_change": 119.5,
          "week_change": 3457135,
          "percent_week_change": 158.25,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        },
        {
          "date": "2021-08-02 00:00:00",
          "gas_used": 296104,
          "total_gas": 215825484648,
          "day_change": -344007,
          "percent_day_change": -53.74,
          "week_change": 3733768,
          "percent_week_change": 170.91,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        },
        {
          "date": "2021-08-03 00:00:00",
          "gas_used": 131864,
          "total_gas": 215825616512,
          "day_change": -164240,
          "percent_day_change": -55.47,
          "week_change": 3990937,
          "percent_week_change": 240.66,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        },
        {
          "date": "2021-08-04 00:00:00",
          "gas_used": 730195,
          "total_gas": 215826346707,
          "day_change": 598331,
          "percent_day_change": 453.75,
          "week_change": 5091659,
          "percent_week_change": 437.69,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        },
        {
          "date": "2021-08-05 00:00:00",
          "gas_used": 254793,
          "total_gas": 215826601500,
          "day_change": -475402,
          "percent_day_change": -65.11,
          "week_change": 5229170,
          "percent_week_change": 452.25,
          "ethereum_contract_id": "0x0000000000b3F879cb30FE243b4Dfee438691c04"
        }
      ]
    }
  ],
  "links": {
    "first": "/?page=1",
    "last": "/?page=722",
    "prev": null,
    "next": "/?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 722,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "/?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "/?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": "/?page=3",
        "label": "3",
        "active": false
      },
      {
        "url": "/?page=4",
        "label": "4",
        "active": false
      },
      {
        "url": "/?page=5",
        "label": "5",
        "active": false
      },
      {
        "url": "/?page=6",
        "label": "6",
        "active": false
      },
      {
        "url": "/?page=7",
        "label": "7",
        "active": false
      },
      {
        "url": "/?page=8",
        "label": "8",
        "active": false
      },
      {
        "url": "/?page=9",
        "label": "9",
        "active": false
      },
      {
        "url": "/?page=10",
        "label": "10",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "/?page=721",
        "label": "721",
        "active": false
      },
      {
        "url": "/?page=722",
        "label": "722",
        "active": false
      },
      {
        "url": "/?page=2",
        "label": "Next »",
        "active": false
      }
    ],
    "path": "/",
    "per_page": 3,
    "to": 3,
    "total": 2165
  }
}

404 Could not find a cake matching this query.

Sorting

You can programmatically sort the result by one of the column rows as seen on Carbon Market Cap.

Rank

Use rank to sort the results by the carbon debt of a project, the total_carbon_debt property is linked to the rank.

Transactions Count

Use transactions_count to sort by the number of transactions a project has.

Changes over time

Use percent_day_change or percent_week_change to view the projects that have the highest or lowest emission change over the last day or week.

Cost to offset

Use cost_to_offset and dov_to_offset to view projects to return a concrete price of a project to become carbon neutral.