Для разработчиков и продавцов

Telegram Premium API

Дарите Telegram Premium любому @username из своего бота, магазина или платформы одним REST-запросом.

Telegram Premium API от TGTools — это REST-эндпоинт для программного дарения Telegram Premium. Отправьте POST /api/purchase/premium с username получателя и планом на 3, 6 или 12 месяцев, авторизуйтесь заголовком X-Api-Key — и подписка активируется через Fragment.com за секунды. Перед заказом GET /api/purchase/user/{username} подтверждает, что аккаунт существует и может получить Премиум, а GET /api/purchase/prices возвращает актуальные цены планов в TON — оба без авторизации. API-ключ вы создаёте сами в веб-панели, до пяти активных ключей, без анкеты и звонка менеджера. Подписки и платы за запрос нет: заказы оплачиваются с баланса кошелька TGTools, каждый ответ — предсказуемый JSON, а у каждого ключа есть собственный лог вызовов в панели.

Превью эндпоинтов API

Бесплатный API-ключ · без KYC
Полная документация API →

Верификация личности не нужна — зарегистрируйтесь, создайте API-ключ и отправляйте заказы за минуты.

Доступ к API бесплатный. Вы платите только за звёзды, Премиум или NFT с баланса TON-кошелька.

Авторизация: X-Api-Key: tgt_… или Authorization: Bearer tgt_…

Базовый URL: https://api.tg-tools.shop

Звёзды и Премиум Телеграм (Fragment)

  • POST/api/purchase/stars

    Купить звёзды Телеграм для любого username — мгновенно через Fragment.

  • POST/api/purchase/premium

    Подарить Премиум (3, 6 или 12 месяцев) программно.

  • GET/api/purchase/pricesPublic

    Актуальные цены звёзд и Премиума в TON.

  • GET/api/purchase/user/{username}

    Проверить пользователя Телеграм перед заказом.

NFT-подарки и маркетплейс

  • POST/api/marketplace/buy/auto

    Автопокупка NFT-подарка и доставка на TON-кошелёк.

  • GET/api/marketplace/collections

    Коллекции NFT, supply и floor price.

  • GET/api/marketplace/nft?address=…

    Детали NFT, статус продажи и цена.

  • GET/api/marketplace/quote?address=…

    Котировка покупки с комиссией.

Кошелёк и заказы

  • GET/api/wallet

    Баланс TON и адрес для депозита.

  • GET/api/transaction

    История заказов звёзд, Премиума и NFT.

  • GET/api/marketplace/orders/{id}

    Статус заказа на покупку NFT.

Почему TGTools

  • Подарок Премиума на 3, 6 или 12 месяцев одним POST-запросом
  • Сначала проверьте получателя — GET /api/purchase/user/{username}, без авторизации
  • Актуальные цены планов из GET /api/purchase/prices
  • Мгновенная активация через Fragment.com
  • Самостоятельный API-ключ, без KYC и звонков
  • Оплата за заказ с кошелька — без подписки

Возможности платформы

  • POST /api/purchase/premium — { recipientUsername, months: 3 | 6 | 12, paymentMethod, trackingCode }
  • GET /api/purchase/user/{username} — found, displayName, premiumEligible (публичный)
  • GET /api/purchase/prices — premium_3m_ton, premium_6m_ton, premium_12m_ton (публичный)
  • GET /api/transaction/{id} — status, quotedTotalTon, costTon, providerReference
  • GET /api/wallet — баланс для планирования заказов
  • Тот же ключ покупает звёзды, подарочные карты, игровые пополнения и подарки Telegram

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

  1. 1

    Получите API-ключ

    Создайте аккаунт и сгенерируйте API-ключ в панели.

  2. 2

    Интеграция

    Используйте REST API — или панель — для покупки звёзд и Премиума.

  3. 3

    Мониторинг

    Отслеживайте каждый заказ, баланс кошелька и историю в реальном времени.

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

Как подарить Telegram Premium через API?

POST /api/purchase/premium с recipientUsername и months (3, 6 или 12) плюс заголовок X-Api-Key. В ответе — transactionId и status; активация идёт через Fragment.com.

Можно ли проверить, может ли username получить Премиум?

Да. GET /api/purchase/user/{username} публичный и возвращает found и premiumEligible — проверяйте до списания с клиента.

Сколько стоит Telegram Premium через API?

Актуальные оптовые цены на 3, 6 и 12 месяцев возвращает GET /api/purchase/prices в TON; ставки одинаковы для всех ключей.

Как получить ключ Telegram Premium API?

Создайте бесплатный аккаунт TGTools, откройте Настройки → API-ключи и сгенерируйте ключ — до пяти активных. Документация: /api-docs.

Есть ли ежемесячная плата?

Нет. Доступ к API бесплатный; вы платите только за заказанные подарки Премиума с баланса кошелька.

Что ещё умеет ключ?

Покупать звёзды Telegram (POST /api/purchase/stars), подарочные карты и игровые пополнения (POST /api/catalog/buy) и коллекционные подарки Telegram (POST /api/marketplace/buy/auto).

Готовы начать?

Регистрация за секунды. Без скрытых комиссий. Мгновенная доставка.