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 бесплатный. Вы платите только за звёзды, Премиум или 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
Получите API-ключ
Создайте аккаунт и сгенерируйте API-ключ в панели.
- 2
Интеграция
Используйте REST API — или панель — для покупки звёзд и Премиума.
- 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.
Готовы начать?
Регистрация за секунды. Без скрытых комиссий. Мгновенная доставка.
