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).
{
"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
}
}{ "message": "Ain't no cake like that."}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.
Last updated