For developers & sellers

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 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

  • 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. 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 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.