Config Stats

Requires partner scope Returns aggregate donation stats for a single config owned by your developer project. This includes volumes broken down by chain and token.

Get config stats

GET /configs/{configId}/stats

curl https://www.donate.gg/api/v1/configs/0x1234...abcd/stats \
  -H "donate-api-key: YOUR_API_KEY"

Path parameters

Parameter	Description
`configId`	The config ID (hex string or base58 encoding)

Response

{
  "channels": {
    "1": { "0xA0b8...": "1000000000000000000" },
    "101": { "So11...": "500000000" }
  },
  "usdDonatedE6": "150000000",
  "donationCount": "42",
  "firstDonationDate": "2025-01-15T12:00:00.000Z",
  "lastDonationDate": "2026-04-20T18:30:00.000Z"
}

Field	Type	Description
`channels`	object	`{ [chainId]: { [tokenAddress]: totalGrossAtomicVolume } }`. Amounts are atomic strings.
`usdDonatedE6`	string	Total USD donated × 10^6
`donationCount`	string	Total number of donations
`firstDonationDate`	string \| null	ISO 8601 timestamp of first donation, or `null`
`lastDonationDate`	string \| null	ISO 8601 timestamp of most recent donation, or `null`

Error responses

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid config ID format
`403`	`SCOPE_DENIED`	The `partner` scope is not enabled for your organization
`403`	`FORBIDDEN`	Config does not belong to this developer project
`404`	`NOT_FOUND`	No config found with the given ID

Getting Started

Developer

Core API

Partner API

Blockchain

AI & LLMs

For Non-profits

Other

Get config stats

​Get config stats

Get config stats