# Документация API Донатти

Получайте донаты, цели и топ донатеров своего канала в боте или на своём сайте.

### Бот или сервер

Новые донаты в чат, оверлей или свою программу. Нужно уметь запустить скрипт в терминале.

- [Быстрый старт: запрос из терминала](https://developers.donatty.com/quickstart/bot.md)
- [Какие донаты показывать на стриме](https://developers.donatty.com/quickstart/bot.md#что-показывать-на-стриме)
- Готовый бот: [Node.js](https://developers.donatty.com/examples/bot-node.md) · [Python](https://developers.donatty.com/examples/bot-python.md)

### Сайт

Цель, топ или сумма донатов на вашей странице. Нужно знать HTML и немного JavaScript.

- [Быстрый старт: запрос из браузера](https://developers.donatty.com/quickstart/website.md)
- [Готовая страница с целью](https://developers.donatty.com/examples/goal-html.md)
- [Добавить адрес сайта к ключу](https://developers.donatty.com/quickstart/website.md#добавьте-адреса-с-которых-открывается-страница)

## Примеры запросов



**Донаты:**


```sh
curl -s "https://api.donatty.com/v1/donations?limit=5&moderation=PASSED,NONE" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

```json
{
  "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
}
```

Отправить такой запрос со своим ключом: [страница метода «Донаты»](https://developers.donatty.com/reference/donations.md).

**Цели:**


```sh
curl -s "https://api.donatty.com/v1/goals?status=ACTIVE&limit=1" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

```json
{
  "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"
}
```

Отправить такой запрос со своим ключом: [страница метода «Цели сбора»](https://developers.donatty.com/reference/goals.md).

**Топ:**


```sh
curl -s "https://api.donatty.com/v1/stats/top?period=WEEK&limit=3" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

```json
{
  "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"
      }
    }
  ]
}
```

Отправить такой запрос со своим ключом: [страница метода «Топ донатеров»](https://developers.donatty.com/reference/stats-top.md).

**Сумма:**


```sh
curl -s "https://api.donatty.com/v1/stats/total?period=DAY&timeZone=Asia/Novosibirsk" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

```json
{
  "period": "DAY",
  "from": "2026-11-09T17:00:00Z",
  "to": "2026-11-10T17:00:00Z",
  "total": {
    "value": "18250.25",
    "currency": "RUB"
  }
}
```

Отправить такой запрос со своим ключом: [страница метода «Сумма донатов»](https://developers.donatty.com/reference/stats-total.md).

**Профиль:**


```sh
curl -s "https://api.donatty.com/v1/streamer" \
  -H "Authorization: Bearer $DONATTY_TOKEN"
```

```json
{
  "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"
}
```

Отправить такой запрос со своим ключом: [страница метода «Профиль стримера»](https://developers.donatty.com/reference/streamer.md).



## Справочник API

- [Профиль стримера](https://developers.donatty.com/reference/streamer.md): Ник, аватар и ссылка на страницу доната.
- [Донаты](https://developers.donatty.com/reference/donations.md): Все донаты от новых к старым, со статусом модерации.
- [Цели сбора](https://developers.donatty.com/reference/goals.md): Название, цель и собранная сумма.
- [Топ донатеров](https://developers.donatty.com/reference/stats-top.md): Лучшие донатеры за день, неделю, месяц, год или всё время.
- [Сумма донатов](https://developers.donatty.com/reference/stats-total.md): Сколько пришло за период.
- [Все методы](https://developers.donatty.com/reference.md): Адрес API, ключи и OpenAPI.

## Основы

- [Ключи](https://developers.donatty.com/tokens.md): Секретный для бота, публичный для сайта.
- [Работа с данными](https://developers.donatty.com/data.md): Страницы, деньги, время, пустой ответ.
- [Лимиты запросов](https://developers.donatty.com/rate-limits.md): Сколько запросов в минуту и что делать после 429.
- [Ошибки](https://developers.donatty.com/errors.md): Что значит код из ответа и как исправить.

## Если не получилось

- [Частые вопросы](https://developers.donatty.com/faq.md): OBS, тестовый донат, пустой список, CORS
- [Статус сервиса](https://status.donatty.com/)

## Ещё

- [Изменения API](https://developers.donatty.com/changelog.md)
- [Раздел «Разработчикам» в кабинете](https://streamer.donatty.com/developers): выпустить ключ
- Для программ и ИИ-ассистентов: [llms.txt](https://developers.donatty.com/llms.txt) · [openapi.json](https://developers.donatty.com/openapi.json)
