For developers & sellers

Gift Card API

Sell gift cards and game top-ups from your own bot or store — one catalog, one POST, code delivered by API.

The TGTools gift card API gives your bot, store or platform a wholesale catalog of gift cards and game top-ups behind one REST key. GET /api/catalog lists products by category — gift cards such as Steam, Apple, PlayStation and Amazon, and top-ups such as PUBG Mobile and Free Fire — with regional variants, retail USD and live TON prices, and it needs no authentication. GET /api/catalog/item returns one product with all denominations. To order, send POST /api/catalog/buy with a productId, quantity and, for gaming top-ups, the playerId; the order is processed automatically and GET /api/catalog/orders/{id} returns the deliveryCode once it is completed. Steam wallet top-ups have their own endpoints under /api/steam-topup with live rates and quotes. Keys are self-serve in the dashboard, there is no subscription, and orders are paid from your wallet balance.

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

  • Public catalog — GET /api/catalog and /api/catalog/item need no key
  • Gift cards and game top-ups with regional variants and live TON prices
  • One POST to order, delivery code returned by API
  • Steam wallet top-ups with live rates via /api/steam-topup
  • Self-serve API key, no subscription
  • Same key covers Stars, Premium and Telegram gifts

Platform features

  • GET /api/catalog?category=giftcards|topups&q=… — paged products with variants
  • GET /api/catalog/item?key=giftcards:amazon — one product, all denominations
  • POST /api/catalog/buy — { productId, quantity, playerId? }
  • GET /api/catalog/orders and /api/catalog/orders/{id} — status and deliveryCode
  • GET /api/steam-topup/rates and /quote — Steam wallet pricing
  • POST /api/steam-topup/buy — { steamLogin, currency, amount }

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

Which gift cards can I buy through the API?

Whatever is in the live catalog: GET /api/catalog?category=giftcards returns regional gift cards (Steam, Apple, PlayStation, Amazon and more) with denominations and current prices.

How is a gift card delivered?

After POST /api/catalog/buy the order is processed automatically; poll GET /api/catalog/orders/{id} — the deliveryCode field is filled when the status is Completed.

Can I buy game top-ups too?

Yes. Use category=topups; products that need a player account have requiresPlayerId set, and you pass playerId in the buy request.

Do I need an account to read the catalog?

No. Catalog and item endpoints are public; only /api/catalog/buy and order history require an API key.

How are orders paid?

From your TGTools wallet balance in TON. Catalog prices are live, and there is no subscription or per-request fee.

How do I get a gift card API key?

Create a free account, open Settings → API keys and generate a key (up to five). Documentation is at /api-docs.

Ready to get started?

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