fragment-api-py 6.1.0

Async Python library for Fragment.com API with seqno/balance confirmation and confirmReq

Fragment API Python

Professional Python library for Fragment.com automation

---

Fragment API Python — complete Fragment.com automation: purchase Stars/Premium, giveaways, marketplace, bids, number management. Async-only.

📚 Documentation | 💬 Telegram Chat

---

Features

• Async-only — FragmentClient with full async/await support
• Purchases — Stars (50–10M), Premium (3/6/12 months), TON Ads, payment_method="ton"|"usdt_ton"
• Giveaways — Stars and Premium for channels
• Bids — place_bid(item_type=1|3|5, slug, bid) — if bid equals buy-now price, purchase is instant
• Marketplace — search usernames, numbers, gifts with filters and pagination
• Wallet — V4R2 and V5R1 (W5) support
• Auto-authentication — obtain cookies via TON wallet and Telegram
• Anonymous numbers — manage login codes and terminate sessions
• NFT Management — withdraw gifts to wallet, transfer to other users
• Stars Revenue — withdraw earned Stars to wallet
• Errors — complete exception hierarchy; report unknown errors via issues

---

Installation

pip install fragment-api-py

---

Quick Start

import asyncio
from FragmentAPI import FragmentClient

async def main():
    client = FragmentClient(
        seed="24 words...",
        cookies={"stel_ssid": "...", "stel_token": "...", ...}
    )

    # Wallet info
    w = await client.get_wallet()
    print(f"{w.balance_ton} TON, {w.balance_usdt} USDT")

    # Purchase Stars (USDT)
    await client.purchase_stars("@durov", 100, payment_method="usdt_ton")

    # Purchase Premium (TON, show sender)
    await client.purchase_premium("@durov", 6, show_sender=True)

    # Place bid on username (type 1)
    await client.place_bid(1, "username", bid=150)  # 150 TON

    # Stars giveaway in channel
    await client.giveaway_stars("@channel", winners=5, amount=1000)

    # Search marketplace
    items = await client.search_usernames("gold", filter="sale")

asyncio.run(main())

Auto-cookie Authentication (authenticate method)

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",
        telegram_phone="[phone]"  # or telegram_auth_data
    )

    client = FragmentClient(seed="...", cookies=cookies)

asyncio.run(main())

Async Context Manager

import asyncio
from FragmentAPI import FragmentClient

async def main():
    async with FragmentClient(seed="...", cookies=...) as client:
        wallet = await client.get_wallet()
        result = await client.place_bid(3, "123456789", bid=50)  # number

asyncio.run(main())

Requirements

• Python 3.10+
• Fragment cookies: stel_ssid, stel_dt, stel_token, stel_ton_token
• TON wallet seed phrase

Reporting Errors

For unknown errors — create an Issue or message in Telegram chat. This helps expand the exception database.

---

MIT License