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

Stars API бота Shiba Bank: покупка звёзд Telegram и Telegram Premium на любой @username за USDT или GRAM в сети TON, MCP-сервер для ИИ-агентов, наценка 3 %, примеры запросов и ответы на вопросы.

Обновлено 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".

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

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

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

Fragment — площадка Telegram, где звёзды и Premium покупают вручную: вход через Telegram, кошелёк TON, подтверждение каждого перевода. Через API ваш сервис делает то же одним запросом, а покупку на Fragment и доказательство выдачи бот берёт на себя. О самой площадке — в статье Fragment в Телеграм.

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

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

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

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

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