bohd4nx
6dd9dcb5d4
- Refactor `get_wallet()` to return `ton_balance` and `usdt_balance` in `WalletInfo`. - Update transaction processing to validate balances for both TON and USDT payment methods. - Introduce `parse_required_payment_amount` utility to extract payment amounts from responses. - Modify tests to cover new balance checks and payment method handling. - Upgrade GitHub Actions artifact upload action to v7. - Enhance documentation and examples to reflect changes in wallet balance handling.
Fragment API
Async Python client for the Fragment API. Buy Stars and Premium, top up TON and Ads balances, run giveaways, manage anonymous numbers, and search Fragment listings.
Disclaimer: This project is not affiliated with, endorsed by, or in any way officially connected with Fragment or Telegram.
Installation
pip install pyfragment
To install the latest unreleased changes from the dev branch:
pip install git+https://github.com/bohd4nx/pyfragment.git@dev
Requires Python 3.10+.
Configuration
| Parameter | Type | Default | Description |
|---|---|---|---|
seed |
str |
— | 24-word TON wallet mnemonic |
api_key |
str |
— | Tonapi key from tonconsole.com |
cookies |
dict | str |
— | Fragment session cookies |
wallet_version |
str |
"V5R1" |
"V4R2" or "V5R1" |
timeout |
float |
30.0 |
HTTP request timeout in seconds |
Credentials
Fragment cookies — log in to fragment.com and connect your TON wallet. You can get cookies in two ways:
- Automatically (recommended) — use
get_cookies_from_browser(), which reads them directly from your browser's on-disk store. No extension needed:from pyfragment.utils import get_cookies_from_browser result = get_cookies_from_browser("chrome") # or "firefox", "edge", "brave", ... # result.cookies — dict[str, str] to pass to FragmentClient # result.expires — ISO 8601 expiry of stel_ssid, or None for session cookies - Manually — install Cookie Editor and export these four keys:
stel_ssid,stel_dt,stel_token,stel_ton_token. Pass them as adictor JSON string.
Refresh when you get authentication errors.
Tonapi key — generate at tonconsole.com.
Seed phrase — 24-word mnemonic from your TON wallet (Tonkeeper → Settings → Backup). Never share it.
Usage
import asyncio
from pyfragment import FragmentClient
async def main() -> None:
async with FragmentClient(
seed="word1 word2 ... word24",
api_key="YOUR_TONAPI_KEY",
cookies={
"stel_ssid": "...",
"stel_dt": "...",
"stel_token": "...",
"stel_ton_token": "...",
},
) as client:
wallet = await client.get_wallet()
print(f"Wallet: {wallet.address} | TON: {wallet.ton_balance} | USDT: {wallet.usdt_balance}")
recipient = "https://t.me/username" # also supports: @username, username
stars = await client.purchase_stars(recipient, amount=500, payment_method="usdt_ton")
print(f"Stars sent: {stars.amount} to {stars.username} | tx: {stars.transaction_id}")
premium = await client.purchase_premium(recipient, months=6, payment_method="ton")
print(f"Premium sent: {premium.amount} months to {premium.username} | tx: {premium.transaction_id}")
asyncio.run(main())
Full runnable examples:
Payload debug/decode helper (thanks):
Made with ❤️ by @bohd4nx
Star ⭐ this repo if you found it useful!