Skip to content

v2026.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 Mar 16:28
v2026.1.0
0a71e6c

Added

Giveaways

  • giveaway_stars(channel, winners, amount) — Stars giveaway; 1–5 winners, 500–1 000 000 stars each
  • giveaway_premium(channel, winners, months) — Premium giveaway; 1–24 000 winners, 3/6/12 months each
  • StarsGiveawayResult, PremiumGiveawayResult result types

Telegram Ads

  • recharge_ads(account, amount) — top up a Telegram Ads account; 1–1 000 000 000 TON
  • AdsRechargeResult result type

Marketplace

  • search_usernames(query?, sort?, filter?, offset_id?) — search Fragment usernames; sort: price_desc / price_asc / listed / ending, filter: auction / sale / sold
  • search_numbers(query?, sort?, filter?, offset_id?) — search Fragment anonymous numbers; same sort / filter / pagination semantics
  • search_gifts(query?, collection?, sort?, filter?, view?, attr?, offset?) — search Fragment gifts; attr accepts {"Model": ["Foosball"], "Backdrop": ["Celtic Blue"]}
  • UsernamesResult, NumbersResult, GiftsResult result types

Anonymous numbers

  • get_login_code(number) — fetch the current pending login code
  • toggle_login_codes(number, can_receive) — enable or disable login code delivery
  • terminate_sessions(number) — terminate all active Telegram sessions (two-step flow handled internally)
  • LoginCodeResult, TerminateSessionsResult result types; AnonymousNumberError exception

Raw API

  • FragmentClient.call(method, data, *, page_url) — raw request to any Fragment API method
  • FRAGMENT_BASE_URL constant — base URL shared across all page constants and headers

Examples

  • examples/client/ — wallet_info.py (wallet info), raw_api_call.py (raw API call)
  • examples/numbers/ — manage_number.py (login code fetch, session termination)
  • examples/auctions/ — search_usernames.py, search_numbers.py, search_gifts.py (marketplace search with pagination)
  • examples/purchase/ — send_stars.py, send_premium.py, topup_ton_balance.py, run_stars_giveaway.py, run_premium_giveaway.py, recharge_ads_balance.py

Changed

  • All result types now expose a unified amount field (months and stars removed)
  • __repr__ includes the unit — 3 months, 500 stars, etc.
  • timestamp removed from all result dataclasses
  • All page URL constants built from FRAGMENT_BASE_URL;
  • TransactionError includes an SSL hint; DUPLICATE_SEQNO variant auto-retried up to 2 times (2 s apart)
  • Error messages rewritten: "what happened → why → what to do"

Full Changelog: v2026.0.2...v2026.1.0

Assets 4
Loading