# Telegram Stars API: звёзды и Premium через API

Звёзды и Premium на любой @username одним запросом — для сервисов, ботов и ИИ-агентов.

https://shiba-bank.com/ru/guides/telegram-stars-api

Обновлено 30.09.2026 · 5 мин чтения

Stars API — это HTTP API бота Shiba Bank. Ваш сервис, бот или ИИ-агент покупает звёзды Telegram и Telegram Premium на любой публичный @username и платит в USDT или GRAM в сети TON — или звёздами, которые уже лежат на кошельке в боте. Бот сам покупает звёзды через Fragment, доставляет их получателю и отвечает хешем транзакции, по которому выдачу видно в обозревателе TON.

## Что умеет API

- **Покупать звёзды** на любой @username — от 50 звёзд за заказ.
- **Покупать Telegram Premium** на 3, 6 или 12 месяцев — в подарок любому аккаунту.
- **Проверять получателя до оплаты**: человек это или канал, берёт ли аккаунт плату за сообщения, нет ли у него уже Premium.
- **Переводить звёзды** со своего кошелька на кошельки людей в боте — награды, призы, выплаты.
- **Работать с ИИ-агентами** через MCP-сервер: цены, проверка получателя, заказ и его статус — готовыми инструментами.

## Как это работает

1. В боте откройте `/api`, создайте ключ и включите заказы — по умолчанию они выключены.
2. Узнайте цену: `GET /api/v1/quote?product=stars&quantity=1000`.
3. Проверьте получателя: `POST /api/v1/recipients/check`.
4. Создайте заказ: `POST /api/v1/orders` с полями `product`, `quantity`, `recipient`, `pay` и `idempotency_key`.
5. Оплатите счёт: в ответе адрес проекта, точная сумма и комментарий. Для GRAM там же готовая транзакция TON Connect, для USDT — если передать адрес своего кошелька в `payer_address`.
6. Дождитесь выдачи: `GET /api/v1/orders/{id}?wait=25` отвечает, как только меняется статус. Обычно звёзды приходят получателю за одну-две минуты после оплаты.

> **Важно:** Комментарий к платежу — единственное, что связывает перевод с заказом. Перевод без комментария бот не найдёт.

## Сколько стоит

Наценка на заказы через API — 3 % к стоимости звёзд у Fragment, ниже, чем в самом боте. Точную цену в USDT, GRAM и звёздах кошелька возвращает `GET /api/v1/quote`. Цена фиксируется при создании заказа, а поле `max_price` отклонит заказ, если он дороже вашего потолка. Заказы со звёзд кошелька идут один к одному, без комиссии.

## Оплата звёздами кошелька

Если на вашем кошельке в боте есть звёзды, укажите `pay: "wallet"`: звёзды уйдут получателю один к одному, Premium спишется по цене в звёздах из `/quote`. Выдача начинается сразу, без перевода в сети. Такие заказы считаются в лимитах звёзд ключа вместе с переводами.

## MCP-сервер для ИИ-агентов

Claude, Cursor, ChatGPT и любой клиент MCP подключают API как набор инструментов по одному адресу:

- адрес: `https://shiba-bank.com/api/mcp`;
- заголовок: `Authorization: Bearer <ключ>`;
- инструменты: `get_prices`, `check_recipient`, `create_order`, `get_order`, `list_orders`, `send_stars`, `get_account`.

Для Claude Code достаточно одной команды: `claude mcp add --transport http shiba-bank https://shiba-bank.com/api/mcp --header "Authorization: Bearer $SHIBA_API_KEY"`.

> **Совет:** Передавайте агенту `idempotency_key` в каждом заказе и просите повторять тот же ключ при повторе: так сбой связи не станет вторым заказом.

## Безопасность

- Ключ — 256 случайных бит. Бот хранит только его отпечаток и показывает ключ один раз.
- Заказы выключены, пока вы сами не включите их в `/api`.
- Лимиты: сумма одного счёта и счетов за сутки в долларах, звёзды за перевод и за сутки; список разрешённых IP-адресов.
- У каждого заказа ваш `idempotency_key`: повтор запроса не создаст второй заказ.
- API отвечает только серверам — страница чужого сайта не может использовать ваш ключ из браузера.
- Ключ не может менять свои лимиты, включать себе заказы и видеть чужие данные: настройки меняются только в боте.

## Чем это отличается от покупки на Fragment

Fragment — площадка Telegram, где звёзды и Premium покупают вручную: вход через Telegram, кошелёк TON, подтверждение каждого перевода. Через API ваш сервис делает то же одним запросом, а покупку на Fragment и доказательство выдачи бот берёт на себя. О самой площадке — в статье [Fragment в Телеграм](https://shiba-bank.com/ru/guides/fragment).

## Fragment API: есть ли официальный

У Fragment нет публичного API для покупки звёзд и Premium: на сентябрь 2026 года на fragment.com нет ни документации для разработчиков, ни ключей. Сайт сделан для людей: вход через Telegram, кошелёк TON и подтверждение каждого перевода в кошельке.

Всё, что в поиске называется «Fragment API», — сторонние сервисы и библиотеки, а не Fragment и не Telegram. Часть из них просит seed-фразу вашего TON-кошелька, вход в ваш Telegram или файлы сессии, чтобы платить на Fragment от вашего имени.

> **Важно:** Никому не отправляйте seed-фразу — 24 слова от вашего кошелька. Кто её знает, тот распоряжается всеми деньгами на кошельке, и вернуть их нельзя. То же с кодом входа в Telegram и файлами сессии: это доступ к аккаунту. Настоящий сервис их никогда не просит.

Stars API Shiba Bank ничего из этого не просит: ключ выпускается в боте, а счёт вы оплачиваете обычным переводом со своего кошелька — или звёздами, которые уже лежат на кошельке в боте.

## Частые вопросы

### Есть ли у Fragment официальный API?
Нет: у Fragment нет публичного API для покупки звёзд и Premium. Сервисы, которые называют себя «Fragment API», — сторонние. Не отдавайте им seed-фразу кошелька и вход в Telegram.

### Сколько стоит подключение?
Ключ и запросы ничего не стоят: вы платите только за заказы, наценка — 3 %.

### Можно ли купить звёзды на чужой аккаунт?
Да, на любой публичный @username. Перед оплатой проверьте получателя: канал, группа или бот звёзды не получат, а аккаунт с платными сообщениями не примет меньше, чем стоит его сообщение.

### Что будет, если выдать звёзды не удалось?
Заказ вернётся по правилам бота — обычно звёздами на кошелёк владельца ключа, и статус заказа станет `refunded`.

### Что если повторить запрос после обрыва связи?
Отправьте тот же запрос с тем же `idempotency_key` — вернётся тот же заказ, второго не будет.

### Сколько заказов можно создать?
Одновременно — один счёт на звёзды, всего не больше десяти неоплаченных счетов за десять минут. Потолки суммы одного счёта и счетов за сутки вы задаёте сами в `/api`.

### Где полная документация?
В [документации API](https://shiba-bank.com/api/docs): все адреса, поля, коды ошибок и примеры на Python, Node.js и PHP. Машиночитаемое описание — `/api/v1/openapi.json`.

[Всё — внутри Telegram — Открыть приложение](https://t.me/barboskich_stars_bot?startapp=site_ai_ru)