Reference‐API‐and‐Subgraphs

API and Subgraphs

The frontend renders each page with the data retrieved from the backend API. When you encounter problems, you might want to check the API endpoints directly to compare the data the frontend renders with the ones the backends creates.

API endpoints:

• Mainnet: https://api.carbonmark.com/api/
• Testnet: https://staging-api.carbonmark.com/api
• Docs: https://api.carbonmark.com/documentation/static/index.html (might be not up-to-date 😞)

Projects:

• https://api.carbonmark.com/api/projects
• Frontend Result: => https://www.carbonmark.com/projects

Single Project:

• https://api.carbonmark.com/api/projects/<KEY-VINTAGE> e.g. https://api.carbonmark.com/api/projects/VCS-191-2008
• Frontend Result: => https://www.carbonmark.com/projects/VCS-191-2008

Categories:

• https://api.carbonmark.com/api/categories
• => relevant for the project filters on https://www.carbonmark.com/projects

Countries:

• https://api.carbonmark.com/api/countries
• => relevant for the project filters on https://www.carbonmark.com/projects

Vintages:

• https://api.carbonmark.com/api/vintages
• => relevant for the project filters on https://www.carbonmark.com/projects

Purchases:

• https://api.carbonmark.com/api/purchases/<HASH> e.g. https://api.carbonmark.com/api/purchases/0x7ae9d478700a792f644d05b73f649d9d83393978bcc2d0fa0b44031bab414315
• Frontend Result: => https://www.carbonmark.com/purchases/0x7ae9d478700a792f644d05b73f649d9d83393978bcc2d0fa0b44031bab414315

User (address):

• https://api.carbonmark.com/api/users/<ADDRESS>?type=wallet e.g. https://api.carbonmark.com/api/users/0x39497D2458f92D099cF477cb05b2CF3Ca472DEE0?type=wallet
• Frontend Result: => https://www.carbonmark.com/users/0x39497D2458f92D099cF477cb05b2CF3Ca472DEE0 (redirect to URL with handle if a registered Carbonmark user)

User (handle):

• https://api.carbonmark.com/api/users/<HANDLE>?type=handle e.g. https://api.carbonmark.com/api/users/pixel?type=handle
• Frontend Result: => https://www.carbonmark.com/users/pixel

Subgraphs:

The backend API collects the data for the carbonmark projects and users from several subgraphs.

Mainnet

Cabonmark Subgraph

• https://api.thegraph.com/subgraphs/name/najada/marketplace-matic

Subgraphs Carbonmark Backend uses:

• https://api.thegraph.com/subgraphs/name/cujowolf/klima-refi-current-holdings
• https://api.thegraph.com/subgraphs/name/klimadao/klimadao-pairs
• https://api.thegraph.com/subgraphs/name/klimadao/polygon-bridged-carbon