Fragment API Python SDK

Async Python library for Fragment.com automation
v10.0.0 — GRAM Rebrand | Batch Operations | EVM Payments | Full Marketplace

What's New in v10.0.0

Features

• Async-first — Full async/await support with FragmentClient.
• Purchases — Stars (50–10M), Premium (3/6/12 months), GRAM Ads top-up.
• Batch Operations — Multiple purchases in grouped on-chain transactions.
• EVM Payments — USDT/USDC on Ethereum, Polygon, and BASE chains.
• Giveaways — Stars and Premium giveaways for channels (up to 24K winners).
• Marketplace — Search/bid on usernames, numbers, and gifts with full pagination.
• Auctions — Start auctions, set fixed prices, place bids, buy-now.
• NFTs — Transfer, withdraw to wallet, manage Stars revenue.
• Wallet — V4R2 and V5R1 support via tonutils. GRAM and USDT balances.
• Authentication — Auto-authenticate via TON wallet proof + Telegram OAuth (QR/phone).
• Anonymous Numbers — Login codes, toggle delivery, terminate sessions (+888).
• Asset Management — List owned assets, bid history, assign to Telegram accounts.

Installation

pip install fragment-api-py

Requirements:

• Python 3.10+
• Fragment cookies (stel_ssid, stel_dt, stel_token; stel_ton_token for wallet operations)
• TON wallet seed phrase (12/18/24 words) — for on-chain transactions
• Tonconsole or Toncenter API key — for blockchain interactions

Get a free API key at tonconsole.com.

Quick Start

import asyncio
from FragmentAPI import FragmentClient
from FragmentAPI.types.results import EvmPaymentResult

async def main():
    async with FragmentClient(
        cookies={
            "stel_ssid": "...",
            "stel_token": "...",
            "stel_dt": "...",
            "stel_ton_token": "..."
        },
        seed="word1 word2 ... word24",
        api_key="AF...",
        wallet_version="V5R1",
    ) as client:
        
        # Wallet info
        wallet = await client.get_wallet()
        print(f"Balance: {wallet.gram_balance} GRAM, {wallet.usdt_balance} USDT")
        
        # Purchase Stars
        result = await client.purchase_stars("durov", 100)
        print(f"TX: {result.transaction_id}")
        
        # Batch operations
        batch = await client.batch_purchase([
            {"type": "premium", "username": "durov", "months": 3},
            {"type": "stars", "username": "telegram", "amount": 250},
        ])
        print(f"Batch: {batch.succeeded}/{batch.total} succeeded")

        # EVM payment
        evm = await client.purchase_stars("durov", 50, payment_method="usdc_base")
        if isinstance(evm, EvmPaymentResult):
            inv = evm.invoice
            print(f"Send {inv.invoice_amount} {inv.token_symbol} to {inv.invoice_address}")

asyncio.run(main())

Authentication

import asyncio
from FragmentAPI import FragmentClient

async def main():
    # Auto-authenticate via TON wallet + Telegram
    cookies = await FragmentClient.authenticate(
        seed="word1 word2 ... word24",
        wallet_version="V5R1",
        phone="+71234567890",  # Omit for QR code flow
    )
    
    async with FragmentClient(
        cookies=cookies,
        seed="word1 word2 ... word24",
        api_key="AF...",
    ) as client:
        profile = await client.get_profile()
        print(f"Logged in as: {profile.name}")

asyncio.run(main())

Payment Methods

API Overview

For complete method signatures, parameters, return types, and models, see the Full Documentation (DOC.md).

Purchases & Giveaways

Marketplace

Asset Info & History

Account & Assets

NFTs & Withdrawals

Anonymous Numbers

Support & License

Issues: GitHub Issues or Telegram Chat

Support the Project:

UQBsyxZvyQxDwAeOxoaWwO2HJoAmCKUoJlS_OpLzWHD9i2Xj

License: MIT — free for commercial and personal use.

GitHub • Documentation • Telegram