fragment-api-dev

The focused Python SDK for buying Telegram Stars and Telegram Premium through Fragment.

• GRAM and USDT on TON
• No API key
• Automatic status polling
• Zero runtime dependencies

Install

pip install fragment-api-dev

Quick start

import os

from fragment_api import FragmentAPI


api = FragmentAPI()

purchase = api.buy_stars(
    username="@telegram_user",
    amount=50,
    payment_method="gram",
    seed=os.environ["TON_WALLET_SEED"],
)

result = api.wait(purchase.purchase_id)

if result.completed:
    print("Delivered:", result.transaction_hash)
else:
    print("Not completed:", result.status, result.error)

The SDK generates an idempotency key automatically, submits the purchase, and provides a typed Purchase result.

Prices

Get the 50-Stars reference price and Premium prices for 3, 6, and 12 months before showing a price to your customer:

catalog = api.get_prices()
print(catalog.stars.amount, catalog.stars.prices.gram, catalog.stars.prices.usdt)

quote = api.get_stars_price(100)
print(quote.prices.gram, quote.prices.usdt)

Use get_premium_price(3), get_premium_price(6), or get_premium_price(12) for Premium. Price values are strings to preserve their exact decimal value. A quote can have stale=True when the latest available quote is being served.

Telegram Premium

purchase = api.buy_premium(
    username="@telegram_user",
    months=3,
    payment_method="usdt",
    seed=os.environ["TON_WALLET_SEED"],
)

result = api.wait(purchase.purchase_id)

Premium durations are 3, 6, or 12 months.

Payments

USDT purchases require a small GRAM balance for the network fee.

Public API

No authentication token or API key is required.

Links

• GitHub repository
• REST and Node.js examples
• OpenAPI specification
• API status
• Integration support