Bot or server
New donations in chat, an overlay or your own program. You need to be able to run a script in a terminal.
Bot or server
New donations in chat, an overlay or your own program. You need to be able to run a script in a terminal.
Website
A goal, top donors or a total on your page. You need HTML and a little JavaScript.
curl -s "https://api.donatty.com/v1/donations?limit=5&moderation=PASSED,NONE" \ -H "Authorization: Bearer $DONATTY_TOKEN"{ "items": [ { "id": "don_5d2e8f31-6a47-4c19-9b0e-7f3a2d1c8e46", "createdAt": "2026-11-09T10:21:47Z", "source": "DONATTY", "donorName": "Алексей", "message": "Спасибо за стрим!", "amount": { "value": "500.00", "currency": "RUB" }, "feeCompensation": { "value": "27.00", "currency": "RUB" }, "paymentMethod": "CARD", "goal": null, "moderation": { "status": "PASSED", "deadline": null }, "media": null }, { "id": "don_9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "createdAt": "2026-11-09T09:58:00Z", "source": "DONATION_ALERTS", "donorName": "Maria", "message": "Hi from Donation Alerts", "amount": { "value": "5.00", "currency": "USD" }, "feeCompensation": null, "paymentMethod": null, "goal": null, "moderation": { "status": "NONE", "deadline": null }, "media": null } ], "nextCursor": null}Send this request with your own key: the Donations method page.
curl -s "https://api.donatty.com/v1/goals?status=ACTIVE&limit=1" \ -H "Authorization: Bearer $DONATTY_TOKEN"{ "items": [ { "id": "goal_7e3a9c10-4b2d-4f8e-a1c6-0d9b8e7f6a52", "title": "New microphone", "target": { "value": "15000.00", "currency": "RUB" }, "raised": { "value": "6420.50", "currency": "RUB" }, "status": "ACTIVE", "endsAt": "2026-12-31T21:00:00Z", "createdAt": "2026-10-01T12:00:00Z" } ], "nextCursor": "MTc5MDg1NjAwMDAwMDAwMC43ZTNhOWMxMC00YjJkLTRmOGUtYTFjNi0wZDliOGU3ZjZhNTI"}Send this request with your own key: the Fundraising goals method page.
curl -s "https://api.donatty.com/v1/stats/top?period=WEEK&limit=3" \ -H "Authorization: Bearer $DONATTY_TOKEN"{ "period": "WEEK", "from": "2026-11-08T21:00:00Z", "to": "2026-11-15T21:00:00Z", "items": [ { "rank": 1, "name": "Alex", "total": { "value": "12500.00", "currency": "RUB" } }, { "rank": 2, "name": "Maria", "total": { "value": "4300.75", "currency": "RUB" } }, { "rank": 3, "name": "Ivan", "total": { "value": "1000.00", "currency": "RUB" } } ]}Send this request with your own key: the Top donors method page.
curl -s "https://api.donatty.com/v1/stats/total?period=DAY&timeZone=Asia/Novosibirsk" \ -H "Authorization: Bearer $DONATTY_TOKEN"{ "period": "DAY", "from": "2026-11-09T17:00:00Z", "to": "2026-11-10T17:00:00Z", "total": { "value": "18250.25", "currency": "RUB" }}Send this request with your own key: the Total donated method page.
curl -s "https://api.donatty.com/v1/streamer" \ -H "Authorization: Bearer $DONATTY_TOKEN"{ "id": "str_5b0c2f4e-8d61-4f43-9a7e-2f1d3c6b9a10", "slug": "teststreamer", "displayName": "Test Streamer", "avatarUrl": "https://storage.donatty.com/avatars/teststreamer.png", "donatePageUrl": "https://donatty.com/teststreamer"}Send this request with your own key: the Streamer profile method page.