Telegram Premium API
Gift Telegram Premium to any @username from your bot, store or platform with one REST call.
The TGTools Telegram Premium API is a REST endpoint for gifting Telegram Premium programmatically. Send POST /api/purchase/premium with the recipient's username and a plan of 3, 6 or 12 months, authenticate with an X-Api-Key header, and the subscription is activated through Fragment.com within seconds. Before ordering, GET /api/purchase/user/{username} confirms the account exists and is eligible for Premium, and GET /api/purchase/prices returns the live plan prices in TON — both without authentication. You create the API key yourself in the web dashboard, up to five active keys, with no application form or sales call. There is no subscription and no per-request fee: orders are paid from your TGTools wallet balance, every response is predictable JSON, and each key keeps its own call log in the dashboard.
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
- Gift 3-, 6- or 12-month Premium with one POST request
- Validate the recipient first — GET /api/purchase/user/{username}, no auth
- Live plan prices from GET /api/purchase/prices
- Instant activation through Fragment.com
- Self-serve API key, no KYC, no sales call
- Pay per order from your wallet — no subscription
Platform features
- POST /api/purchase/premium — { recipientUsername, months: 3 | 6 | 12, paymentMethod, trackingCode }
- GET /api/purchase/user/{username} — found, displayName, premiumEligible (public)
- GET /api/purchase/prices — premium_3m_ton, premium_6m_ton, premium_12m_ton (public)
- GET /api/transaction/{id} — status, quotedTotalTon, costTon, providerReference
- GET /api/wallet — balance to budget orders
- The same key buys Stars, gift cards, game top-ups and Telegram gifts
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 gift Telegram Premium with the API?
POST /api/purchase/premium with recipientUsername and months (3, 6 or 12) plus your X-Api-Key header. The response includes transactionId and status; activation runs through Fragment.com.
Can I check whether a username can receive Premium?
Yes. GET /api/purchase/user/{username} is public and returns found and premiumEligible, so you can validate before charging your customer.
How much does Telegram Premium cost via API?
Live wholesale prices for 3, 6 and 12 months are returned by GET /api/purchase/prices in TON; the same rates apply to every key.
How do I get a Telegram Premium API key?
Create a free TGTools account, open Settings → API keys and generate a key — up to five active keys. Documentation is at /api-docs.
Is there a monthly fee?
No. API access is free; you pay only for the Premium gifts you order, from your wallet balance.
What else can the key do?
Buy Telegram Stars (POST /api/purchase/stars), gift cards and game top-ups (POST /api/catalog/buy) and collectible Telegram gifts (POST /api/marketplace/buy/auto).
Ready to get started?
Sign up in seconds. No hidden fees. Instant delivery.
