# donate.gg

- [Welcome](https://docs.donate.gg/getting-started/welcome.md): Get started with Donate.gg
- [Overview](https://docs.donate.gg/developer/overview.md): Integrate donate.gg into your product with the Developer API
- [Getting Access](https://docs.donate.gg/developer/getting-access.md): Access the Developer Portal and manage API keys
- [Authentication](https://docs.donate.gg/developer/authentication.md): Authenticate project-private requests with a `donate-api-key` header; public reads may omit it
- [Rate Limits](https://docs.donate.gg/developer/rate-limits.md): Understand how rate limiting works for API keys and anonymous public reads
- [Donation Journey](https://docs.donate.gg/developer/donation-journey.md): How a donation moves from on-chain transaction to the beneficiary
- [Use Case](https://docs.donate.gg/developer/use-case.md): Example: add donations to a game
- [Charities](https://docs.donate.gg/api/charities.md): Browse and search charities on Donate.gg
- [Chains](https://docs.donate.gg/api/chains.md): Query which chains are supported for donations
- [Categories](https://docs.donate.gg/api/categories.md): List campaign categories
- [Campaigns](https://docs.donate.gg/api/campaigns.md): Browse active campaigns, stats, donations, and donation-echo addresses
- [Charity Coins](https://docs.donate.gg/api/charity-coins.md): Browse charity-coin subjects and creators
- [Users](https://docs.donate.gg/api/users.md): Public user receiver stats
- [Donation Configs](https://docs.donate.gg/api/donation-configs.md): Create, list, inspect, and delete donation configs
- [Config Stats](https://docs.donate.gg/api/config-stats.md): Fetch aggregate donation stats for a config you own
- [Config Leaderboard](https://docs.donate.gg/api/config-leaderboard.md): Fetch the top donors leaderboard for a config you own
- [Source Leaderboard](https://docs.donate.gg/api/source-leaderboard.md): View donation subject stats for a donation source owned by your project
- [Token by Address](https://docs.donate.gg/api/charity-tokens/token-address-route.md): Fetch a Charity Token by chain and token address
- [Token Stats by Address](https://docs.donate.gg/api/charity-tokens/token-stats-route.md): Fetch donation stats for a Charity Token by chain and token address
- [Token Leaderboard](https://docs.donate.gg/api/charity-tokens/token-leaderboard.md): View public Charity Token rankings for a chain
- [Solana (SVM)](https://docs.donate.gg/blockchain/solana-svm.md): Integrate Donate.gg on Solana using the Donation Relay program
- [EVM](https://docs.donate.gg/blockchain/evm.md): Integrate Donate.gg on EVM chains using the donation relay contract
- [Bridged EVM donations](https://docs.donate.gg/blockchain/donation-bridge.md): Use familiar donation calls on an entry chain, with USDC settlement on Base
- [MCP Server](https://docs.donate.gg/ai/mcp.md): Connect donate.gg docs to your AI tools via Model Context Protocol
- [llms-full.txt](https://docs.donate.gg/ai/llms-full.md): Full donate.gg documentation in a single text file
- [Overview](https://docs.donate.gg/non-profits/overview.md): How Donate.gg works for non-profits and charities
- [See Your Charity?](https://docs.donate.gg/non-profits/see-your-charity.md): Is your non-profit listed on Donate.gg? Here is what to know.
- [FAQ](https://docs.donate.gg/non-profits/faq.md): Answers to common questions about Donate.gg
- [Branding](https://docs.donate.gg/non-profits/branding.md): Donate.gg brand assets and guidelines
- [List categories](https://docs.donate.gg/api-reference/list-categories.md): List campaign categories.
- [List chains](https://docs.donate.gg/api-reference/list-chains.md): List all chains supported by donate.gg.
- [List charities](https://docs.donate.gg/api-reference/list-charities.md): List Charity records with full metadata and optional participation filtering.
- [Search charities](https://docs.donate.gg/api-reference/search-charities.md): Search charities by name or slug.
- [Recently listed charities](https://docs.donate.gg/api-reference/recently-listed-charities.md): Newest active charities by listing time (`listedAt` is the Charity row createdAt). One page of about 50. Active statuses only. Use this to watch for newly added charities. Search is a typeahead and is not a change feed. A soft-hidden charity that is restored keeps its original createdAt and does not…
- [Recently listed charities (Atom)](https://docs.donate.gg/api-reference/recently-listed-charities-atom.md): Atom 1.0 feed of the same recently listed active charities as GET /charities/feed. The feed author is donate.gg. Entry id is tag:donate.gg,2026:charity:{id}. Entry link is the public charity page. Entry updated is listedAt.
- [Get a charity by id](https://docs.donate.gg/api-reference/get-a-charity-by-id.md): Get a single charity by id (full metadata).
- [List charity donations received](https://docs.donate.gg/api-reference/list-charity-donations-received.md): Paginated list of donations received by a charity.
- [List charity donation messages](https://docs.donate.gg/api-reference/list-charity-donation-messages.md): Paginated list of donations to a charity that include a message.
- [List campaigns](https://docs.donate.gg/api-reference/list-campaigns.md): List active campaigns. Paginated. Non-active campaigns are not returned. Hidden discovery items are excluded unless includeHidden=true.
- [Get campaign stats](https://docs.donate.gg/api-reference/get-campaign-stats.md): Get aggregate donation stats for a campaign. Unknown campaigns return zeroed stats.
- [List campaign donations](https://docs.donate.gg/api-reference/list-campaign-donations.md): Paginated list of donations sent to a campaign.
- [Get or provision campaign donation-echo address](https://docs.donate.gg/api-reference/get-or-provision-campaign-donation-echo-address.md): Lazy get-or-provision of a campaign Donation Echo deposit address for the given chain. May return 202 while provisioning.
- [List configs](https://docs.donate.gg/api-reference/list-configs.md): List configs created by the developer (identified by API key). Paginated.
- [Create a config](https://docs.donate.gg/api-reference/create-a-config.md): Create a config with charity beneficiaries. Requires 1-5 beneficiaries. The standard API fee is 20% (2,000 basis points), set by the server. Each config stores its fee when created; changes to the standard rate do not change that stored fee. The fee is part of the config ID; identical project and be…
- [Get a config by id](https://docs.donate.gg/api-reference/get-a-config-by-id.md): Get a config with its user and charity beneficiaries. Public: any caller may inspect a config by id (Core-scoped). API key is optional.
- [Delete a config](https://docs.donate.gg/api-reference/delete-a-config.md): Delete a config and its beneficiaries. Fails if the config has any existing donations (sent or pending).
- [Get config stats by ID](https://docs.donate.gg/api-reference/get-config-stats-by-id.md): Get aggregate donation stats for a config, including donation channels. Only configs owned by the caller's project are accessible.
- [Get config leaderboard by ID](https://docs.donate.gg/api-reference/get-config-leaderboard-by-id.md): Get a paginated top-donors leaderboard for a config. Only configs owned by the caller's project are accessible.
- [Get a charity token by address](https://docs.donate.gg/api-reference/get-a-charity-token-by-address.md): Get a charity token for a specific chain by its address.
- [Get a charity token stats by address](https://docs.donate.gg/api-reference/get-a-charity-token-stats-by-address.md): Get a charity token stats for a specific chain by its address.
- [Get charity token leaderboard](https://docs.donate.gg/api-reference/get-charity-token-leaderboard.md): Get the leaderboard for top donating tokens for a specific chain.
- [List charity coins](https://docs.donate.gg/api-reference/list-charity-coins.md): Paginated leaderboard of charity-coin donation subjects.
- [List charity-coin creators](https://docs.donate.gg/api-reference/list-charity-coin-creators.md): Paginated leaderboard of charity-coin creators (credited accounts).
- [Get user receiver stats](https://docs.donate.gg/api-reference/get-user-receiver-stats.md): Get aggregate donation receiver stats for a user.
- [Get the subject leaderboard for a given donation source contract](https://docs.donate.gg/api-reference/get-the-subject-leaderboard-for-a-given-donation-source-contract.md): Get the leaderboard for top donating subjects for a specific source contract.
- [Look up bridged donation transfers](https://docs.donate.gg/api-reference/look-up-bridged-donation-transfers.md): Look up bridged-donation progress by `sourceId`, or by origin `chainId` and `transactionHash`.
- [List donation activity](https://docs.donate.gg/api-reference/list-donation-activity.md): List recent donation receipts and in-flight source transfers for a charity or campaign.

## OpenAPI Specs

- [openapi](https://www.donate.gg/api/v1/openapi)

## Optional

- [Follow us](https://x.com/donatedotgg)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.