> ## Documentation Index
> Fetch the complete documentation index at: https://docs.donate.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Charity Coins

> Browse charity-coin subjects and creators

<Badge icon="globe" color="gray" shape="pill">
  Public (API key optional)
</Badge>

Charity Coins endpoints expose the public leaderboard for the configured charity-coins donation source. Anonymous callers may omit `donate-api-key`.

## List charity coins

`GET /charity-coins`

```bash theme={null}
curl "https://www.donate.gg/api/v1/charity-coins?limit=25&sortBy=top-donated"
```

**Query parameters**

| Parameter           | Type                                   | Default | Description                                  |
| ------------------- | -------------------------------------- | ------- | -------------------------------------------- |
| `limit`             | integer                                | `25`    | Results per page, max `100`                  |
| `cursor`            | string                                 | -       | Cursor from previous `pageKey` for next page |
| `sortBy`            | `"top-donated"` \| `"recent-donation"` | -       | Sort order                                   |
| `hideInappropriate` | `"true"` \| `"false"`                  | -       | When `true`, hides inappropriate token names |

**Response (200)** - `{ "pageKey", "response", "tokenImageMap" }` where `tokenImageMap` maps token addresses to icon URLs.

***

## List charity-coin creators

`GET /charity-coins/creators`

```bash theme={null}
curl "https://www.donate.gg/api/v1/charity-coins/creators?limit=25"
```

**Response (200)** - `{ "pageKey", "response", "pumpAccountBundle" }` with creator leaderboard entries and optional Pump account metadata.