For developers & sellers

Telegram Stars & Premium API

Integrate Stars and Premium purchases into your app with one simple REST API.

TGTools gives you a clean REST API for buying Telegram Stars and gifting Telegram Premium programmatically. You generate the API key yourself from the web dashboard in seconds — no application form, no sales chat to wait on, no KYC — then authenticate with a single header and start sending orders, each processed instantly via Fragment.com. Live prices and the product catalog are public endpoints you can call with curl before you even create an account, and every key keeps its own call log in the dashboard so you can see exactly what your integration is doing. The same key also buys Telegram gift NFTs, gift cards and game top-ups, so one integration covers your whole storefront. Whether you run a bot, a store, or a large platform, the Telegram Stars API is built for scale with predictable JSON responses and no TON or Fragment plumbing to maintain yourself.

API endpoints preview

Free API key · No KYC
Full API documentation →

No identity verification required — sign up, generate an API key, and start sending orders in minutes.

API access is free. You only pay for Stars, Premium, or NFT purchases from your TON wallet balance.

Authenticate with X-Api-Key: tgt_… or Authorization: Bearer tgt_…

Base URL: https://api.tg-tools.shop

Telegram Stars & Premium (Fragment)

  • POST/api/purchase/stars

    Buy Telegram Stars for any username — instant Fragment delivery.

  • POST/api/purchase/premium

    Gift Telegram Premium (3, 6, or 12 months) programmatically.

  • GET/api/purchase/pricesPublic

    Live Stars & Premium prices in TON.

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

    Look up a Telegram user before placing an order.

NFT gifts & marketplace

  • POST/api/marketplace/buy/auto

    Auto-buy a Telegram gift NFT and deliver to a TON wallet.

  • GET/api/marketplace/collections

    Browse gift NFT collections, supply, and floor prices.

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

    Fetch NFT details, sale status, and pricing.

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

    Get a buy quote with fees before purchase.

Wallet & orders

  • GET/api/wallet

    Check TON balance and deposit address.

  • GET/api/transaction

    List Stars, Premium, and NFT order history.

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

    Track NFT buy order status.

Why build with TGTools

  • Self-serve API key — no sales chat, no KYC
  • Buy Stars and gift Premium programmatically
  • Public price and catalog endpoints — test before signup
  • Wallet balance, transaction history and per-key call logs
  • One key for Stars, Premium, gift NFTs and gift cards
  • Live in production — every documented endpoint works today

Platform features

  • POST /api/purchase/stars — buy Telegram Stars for any username
  • POST /api/purchase/premium — gift Premium (3, 6 or 12 months)
  • GET /api/purchase/prices — public live price list (no auth required)
  • GET /api/purchase/user/{username} — validate a recipient before ordering
  • GET /api/wallet and /api/transaction — balance and full order history
  • POST /api/marketplace/buy/auto and /api/catalog/buy — gift NFTs, gift cards, top-ups

How it works

  1. 1

    Get your API key

    Create an account and generate an API key from your dashboard.

  2. 2

    Integrate

    Call our REST API — or use the panel — to buy Stars and Premium.

  3. 3

    Monitor

    Track every order, wallet balance and history in real time.

Frequently asked questions

How do I get Telegram Stars API access?

Create a free account and generate an API key from your dashboard — up to 5 active keys. Full docs are at /api-docs.

Do I have to talk to a salesperson first?

No. Key generation is self-serve on the web. There is no application form, no Telegram chat to wait on and no manual approval step.

Is there a subscription or a per-request fee?

No. API access, key generation and the public endpoints are free. You pay only for the products you actually order, from your TGTools wallet balance.

Can I test the API before creating an account?

Yes. GET /api/purchase/prices, GET /api/purchase/user/{username} and GET /api/catalog need no authentication — call them right now with curl.

What else can I sell through the same key?

Beyond Stars and Premium, the same key buys Telegram gift NFTs, gift cards and game top-ups via /api/marketplace and /api/catalog.

What can the API do?

Buy Stars, gift Premium (3/6/12 months), buy gift NFTs and gift cards, check wallet balance and history, and fetch current prices.

How are orders delivered?

Instantly through Fragment.com the moment your request is accepted.

Ready to get started?

Sign up in seconds. No hidden fees. Instant delivery.