Offset your Carbon Emissions

Shipping physical items? Executing transactions on a blockchain? CHANGE makes it simple to offset your carbon consumption. Our Climate API works by powering donations to verified carbon reduction projects. The projects are vetted by Bonneville Environmental Foundation 501(c)(3). Learn more about how they fight climate change on their website.

Get your credentials

The Climate API uses basic authentication. Sign up for a CHANGE account to get access to test credentials. Your test keys have the prefix test, and your production keys have the prefix live.

Offset your emissions

To offset a cryptocurrency transaction, hit our /climate/crypto_offset endpoint. Just specify the currency: Ethereum, Bitcoin, and Solana are currently supported. You can also specify the number of transactions to offset (the default is 1). Use funds_collected to tell us whether you’re collecting a payment for this offset.

# Offsets the emissions cost of 2 ETH transactions.
curl https://api.getchange.io/api/v1/climate/crypto_offset \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "count": 2,
        "currency": "ETH",
        "funds_collected": false
      }'

For physical shipments, hit our /climate/carbon_offset endpoint. Specify the origin and destination zip codes, and the weight of the shipment. If you already know the distance, you can use the distance_mi param. Use funds_collected to tell us whether you’re collecting a payment for this offset. See the api documentation for more.

# Makes a donation that offsets the emissions cost of a 3.5 lb air shipment
# from 60148 to 94133
curl https://api.getchange.io/api/v1/climate/shipping_offset \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "origin_address": "60148",
        "destination_address": "94133",
        "weight_lb": "3.5",
        "funds_collected": false
      }'

Either way, you’ll get a response that looks like this:

{
  // The amount (in cents) that got donated.
  "amount": "18",
  // An ID that references this donation in the CHANGE platform.
  "id": "carbon_tuGjbm2YD8UEsejz4VsbS3GW",
}

Congrats, you just offset your carbon consumption and made the world a better place!

Estimate before donating

Sometimes you want to know how much a carbon offset will cost before making the donation. Perhaps you’d like to give your users the option of making their purchase carbon-neutral, and need to show them the price tag.

To see how much an offset would cost without donating, hit the the same endpoint, but with as a GET instead of a POST:

# Calculates the price of offsetting the emissions cost of 2 ETH transactions
curl https://api.getchange.io/api/v1/climate/shipping_offset \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "origin_address": "60148",
        "destination_address": "94133",
        "weight_lb": "3.5"
      }'
  -G

You’ll get a response that looks like this:

{
  // The cost (in cents) of the carbon offset
  "amount": 18,
  // An ID that can be used to complete the offset.
  "offset_id": "offset_9cj47akb910hm48g7dhrkbc7"
}

If you decide to complete the offset, just POST to the same endpoint using the offset_id that you received. Use funds_collected to tell us whether you’re collecting a payment for this offset.

# Makes an 18 cent donation to carbon reduction projects 
curl https://api.getchange.io/api/v1/climate/shipping_offset \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "offset_id": "offset_9cj47akb910hm48g7dhrkbc7",
        "funds_collected": false
      }'
  -G

You’ll receive proof of your offset in the response:

{
  // The amount (in cents) that got donated.
  "amount": "18",
  // An ID that references the associated donation in the CHANGE platform.
  "id": "carbon_tuGjbm2YD8UEsejz4VsbS3GW",
}

Measure your impact

So you’re improving Earth, but by how much? Qualify your impact with the equivalent number of trees planted by your offsets. These types of stats are great for sharing with your customers. All statistics are verified by Bonneville Environmental Foundation 501(c)(3).

To see stats for an individual donation, use the /donations/{id}/climate_stats endpoint.

curl https://api.getchange.io/api/v1/donations/carbon_tuGjbm2YD8UEsejz4VsbS3GW/climate_stats \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Example response:

{
  // Dollar amount of the carbon offset
  "amount": 18,
  // Equivalent number of trees planted
  "trees": 0.29,
  // Tonnes of C02 offset
  "co2_tonnes_offset": 0.015
}

To see aggregate stats for ALL of your carbon offsets, use the /donations/{id}/climate_stats endpoint.

curl https://api.getchange.io/api/v1/climate/stats
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Example response:

{
  // Total amount of all your carbon offsets
  "amount": 283,
  // Equivalent number of trees planted
  "trees": 4.6,
  // Tonnes of C02 offset
  "co2_tonnes_offset": 0.283
}