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

Telegram Gift API

Покупайте коллекционные подарки Telegram программно и доставляйте их на любой кошелёк TON.

Telegram Gift API от TGTools позволяет вашему боту или платформе покупать коллекционные подарки Telegram — улучшенные подарки, существующие как NFT на TON, — одним REST-запросом. GET /api/marketplace/quote возвращает итоговую сумму для конкретного подарка с разбивкой на цену листинга, комиссию платформы и резерв на газ, а также canBuy. Затем POST /api/marketplace/buy/auto покупает подарок и доставляет его на указанный recipientTonAddress; GET /api/marketplace/orders/{id} отслеживает заказ до статуса Complete. Коллекции и предметы доступны через публичные эндпоинты маркетплейса, так что поверх можно построить магазин подарков, команду бота или автоматического покупателя. Ключи создаются самостоятельно в панели, подписки нет, каждый заказ оплачивается с баланса кошелька по рассчитанной сумме в TON.

Превью эндпоинтов 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

  • Сначала расчёт — GET /api/marketplace/quote показывает цену, комиссию и газ до покупки
  • Один POST покупает и доставляет подарок на любой адрес TON
  • Статус заказа через API до завершения доставки
  • Просмотр коллекций и предметов программно
  • Самостоятельный API-ключ, оплата за заказ с кошелька
  • Тот же ключ покрывает звёзды, Премиум и подарочные карты

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

  • GET /api/marketplace/quote?address=… — listingPriceTon, platformFeeTon, gasBufferTon, totalPriceTon, canBuy
  • POST /api/marketplace/buy/auto — { nftAddress, recipientTonAddress, clientOrderId }
  • GET /api/marketplace/orders/{id} — status, totalPriceTon, nftName
  • GET /api/marketplace/collections и /collections/{address}/items — просмотр каталога
  • GET /api/marketplace/nft и /nft-by-slug — один подарок по адресу или слагу
  • Идемпотентные заказы через clientOrderId

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

  1. 1

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

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

  2. 2

    Интеграция

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

  3. 3

    Мониторинг

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

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

Что такое NFT-подарок Telegram?

Улучшенный подарок Telegram, выпущенный как коллекционный NFT в блокчейне TON. Его можно купить, передать и показать как любой другой NFT.

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

Вызовите GET /api/marketplace/quote с адресом подарка, затем POST /api/marketplace/buy/auto с nftAddress, recipientTonAddress и clientOrderId. Отслеживайте через GET /api/marketplace/orders/{id}.

Куда доставляется подарок?

На адрес кошелька TON, который вы передаёте в recipientTonAddress, — ваш или вашего клиента.

Сколько стоит заказ?

В расчёте указаны цена листинга, комиссия платформы и резерв на газ; итог списывается с баланса кошелька в TON.

Можно ли продавать подарки через API?

Документированный сценарий интеграции — просмотр, расчёт и покупка. Выставить подарки на продажу можно в веб-приложении TGTools на /sales.

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

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

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

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