Python

Pyfragment - async Python SDK for Fragment (Stars, Premium, Ads, Marketplace)

pyfragment — async Python клиент для Fragment API​

Выкладываю свою библиотеку для работы с Fragment API. Делалась под реальные задачи, возможно кому-то пригодится.
pyfragment — асинхронный Python SDK для покупки Telegram Premium, Stars, Ton, работы с маркетплейсом и анонимными номерами.

PyPI | GitHub​

Возможности

• Покупка Telegram Stars и Premium
• Пополнение TON баланса и Telegram Ads
• Розыгрыши Stars и Premium
• Управление анонимными номерами (коды, отключение, завершение сессий)
• Поиск юзернеймов, номеров и подарков на Fragment
• Фильтры, сортировка и пагинация в поиске
• Raw API — вызов любых методов Fragment напрямую

Пример

async def main() -> None:
async with FragmentClient(
seed="word1 word2 ... word24", # 24-word TON wallet mnemonic
api_key="YOUR_TONAPI_KEY", # from tonconsole.com
cookies={
"stel_ssid": "...",
"stel_dt": "...",
"stel_token": "...",
"stel_ton_token": "...",
},
) as client:
try:
# Purchase 6 months of Telegram Premium
result = await client.purchase_premium("@username", months=6)
print(f"{result.amount} months of Premium successfully sent to {result.username} | tx: {result.transaction_id}")

# Purchase 500 Stars
result = await client.purchase_stars("@username", amount=500)
print(f"{result.amount} Stars successfully sent to {result.username} | tx: {result.transaction_id}")

# Top up 10 TON to Telegram balance
# wallet must hold at least amount + ~0.056 TON for gas
result = await client.topup_ton("@username", amount=10)
print(f"{result.amount} TON successfully sent to {result.username} | tx: {result.transaction_id}")

except UserNotFoundError:
print(f"User was not found on fragment.com — check the username and try again.")
except WalletError as e:
print(f"Wallet error — insufficient balance or misconfiguration: {e}")
except CookieError:
print("Authentication failed — session cookies are missing or expired. Refresh them and retry.")
except TransactionError as e:
print(f"Transaction failed to broadcast on-chain: {e}")
except ConfigurationError as e:
print(f"Invalid argument: {e}")
except FragmentAPIError as e:
print(f"Unexpected response from Fragment API: {e}")
except FragmentError as e:
# catch-all for any other pyfragment error
print(f"Unexpected error: {e}")


asyncio.run(main())

Python

async def main() -> None:

    async with FragmentClient(

        seed="word1 word2 ... word24",  # 24-word TON wallet mnemonic

        api_key="YOUR_TONAPI_KEY",       # from tonconsole.com

        cookies={

            "stel_ssid": "...",

            "stel_dt": "...",

            "stel_token": "...",

            "stel_ton_token": "...",

        },

    ) as client:

        try:

            # Purchase 6 months of Telegram Premium

            result = await client.purchase_premium("@username", months=6)

            print(f"{result.amount} months of Premium successfully sent to {result.username} | tx: {result.transaction_id}")



            # Purchase 500 Stars

            result = await client.purchase_stars("@username", amount=500)

            print(f"{result.amount} Stars successfully sent to {result.username} | tx: {result.transaction_id}")



            # Top up 10 TON to Telegram balance

            # wallet must hold at least amount + ~0.056 TON for gas

            result = await client.topup_ton("@username", amount=10)

            print(f"{result.amount} TON successfully sent to {result.username} | tx: {result.transaction_id}")



        except UserNotFoundError:

            print(f"User was not found on fragment.com — check the username and try again.")

        except WalletError as e:

            print(f"Wallet error — insufficient balance or misconfiguration: {e}")

        except CookieError:

            print("Authentication failed — session cookies are missing or expired. Refresh them and retry.")

        except TransactionError as e:

            print(f"Transaction failed to broadcast on-chain: {e}")

        except ConfigurationError as e:

            print(f"Invalid argument: {e}")

        except FragmentAPIError as e:

            print(f"Unexpected response from Fragment API: {e}")

        except FragmentError as e:

            # catch-all for any other pyfragment error

            print(f"Unexpected error: {e}")





asyncio.run(main())