Fragment API Python SDK

Professional Python library for Fragment.com automation
v9.0.0 — Batch Operations | EVM Payments | Tonconsole Integration

• Async-only — FragmentClient with full async/await support.
• Reliable Networking — Requires a direct Tonconsole api_key for maximum uptime.
• Purchases — Stars (50–10M), Premium (3/6/12 months), TON Ads.
• Giveaways — Stars and Premium for channels (up to 24k winners).
• Bids — place_bid(item_type=1|3|5, slug, bid) — instant buy if bid = buy-now price.
• Marketplace — Search usernames, numbers, gifts with filters and pagination.
• Wallet — V4R2 and V5R1 (W5) support via tonutils.
• Auto-authentication — Obtain cookies via TON wallet and Telegram.
• Anonymous numbers — Manage login codes, terminate sessions (+888).
• NFT Management — Withdraw gifts to wallet, transfer to users.

pip install fragment-api-py

• Python 3.10+
• TON wallet seed phrase (12/18/24 words)
• Fragment cookies (stel_ssid, stel_dt, stel_token, stel_ton_token)
• Tonconsole API Key (get one for free at tonconsole.com)

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

async def main():
    # Initialize with strictly required credentials
    async with FragmentClient(
        seed="24 words...",
        api_key="AF...", # Your Tonconsole API key is strictly required
        cookies={
            "stel_ssid": "...", 
            "stel_token": "...", 
            "stel_dt": "...", 
            "stel_ton_token": "..."
        },
        wallet_version="V5R1",
    ) as client:
        
        # 1. Wallet info
        wallet = await client.get_wallet()
        print(f"Balance: {wallet.balance_ton} TON, {wallet.balance_usdt} USDT")
        
        # 2. Purchase stars
        result = await client.purchase_stars("@durov", 100)
        print(f"TX: {result.transaction_id}")
        
        # 3. Execute batch operations
        batch = await client.batch_purchase([
            {"type": "premium", "username": "@durov", "months": 3},
            {"type": "stars", "username": "@telegram", "amount": 250}
        ])
        print(f"Batch Succeeded: {batch.succeeded}/{batch.total}")

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

asyncio.run(main())

import asyncio
from FragmentAPI import FragmentClient

async def main():
    # Automatic authentication via TON wallet and Telegram
    cookies = await FragmentClient.authenticate(
        seed="24 words...",
        wallet_version="V5R1",
        phone="+71234567890"  # Optional: omit for QR code flow
    )
    
    # Use obtained cookies alongside your Tonconsole API key
    async with FragmentClient(
        seed="24 words...", 
        api_key="AF...",
        cookies=cookies
    ) as client:
        profile = await client.get_profile()
        print(f"Logged in as: {profile.name}")

asyncio.run(main())

Reporting Errors
Create an Issue or message in the Telegram chat.

Support the Project
If you find this library useful, consider supporting its development:

UQBsyxZvyQxDwAeOxoaWwO2HJoAmCKUoJlS_OpLzWHD9i2Xj

License
MIT License — free for commercial and personal use.

GitHub • Documentation • Telegram