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 KYCNo 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.shopTelegram Stars & Premium (Fragment)
- POST
/api/purchase/starsBuy Telegram Stars for any username — instant Fragment delivery.
- POST
/api/purchase/premiumGift Telegram Premium (3, 6, or 12 months) programmatically.
- GET
/api/purchase/pricesPublicLive 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/autoAuto-buy a Telegram gift NFT and deliver to a TON wallet.
- GET
/api/marketplace/collectionsBrowse 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/walletCheck TON balance and deposit address.
- GET
/api/transactionList 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
Get your API key
Create an account and generate an API key from your dashboard.
- 2
Integrate
Call our REST API — or use the panel — to buy Stars and Premium.
- 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.
