Skip to main content
The donate.gg Developer API lets you add charitable giving to your product. List participating charities, create donation configs, and send on-chain donations.

​
What you can build

  • Donation widgets: embed a charity selector backed by participating charities
  • Programmatic giving: create configs and donate for your users
  • On-chain integration: call our contracts from your blockchain layer
  • Source leaderboards: track donation activity per token for sources your project owns
  • Charity token stats: fetch public token routes and leaderboard data (API key optional)
  • Config analytics: pull donation stats and donor leaderboards for configs you create (API key required)

Use Case

Walkthrough: integrate the Donate.gg API

​
Main ideas

Charities

Browse and search participating non-profits on donate.gg, including metadata and social links.

Configs

A config sets who receives donations and how weights are split. Configs are permanent. Create and list configs with an API key; inspect-by-id is public.

Chains

See which EVM and Solana chains currently support donations.

Source Leaderboard

View token-level donation stats for donation sources owned by your developer project.

​
API Reference

API Reference

Full endpoint documentation with an interactive playground

​
Base URL

All API requests are made to:
The OpenAPI spec is at /api/openapi. A Postman collection is at /api/postman. Both are public and do not need an API key. /api/v1/openapi and /api/v1/postman serve the same files.
https://www.donate.gg/api is deprecated. It still serves the same routes and data, but new integrations should use https://api.donate.gg/api, and existing ones should switch. Only the host changes: paths, API keys, request bodies and responses stay the same. Replace www.donate.gg (or donate.gg) with api.donate.gg in your base URL.Responses from the old host include a Deprecation header and a Link header with rel="successor-version" that points to the same request on api.donate.gg.

​
Next steps

Getting Access

Get an API key in the Developer Portal

Authentication

Learn how to authenticate your requests