gofragment

gofragment

Go client for the Fragment marketplace API. Buy Stars & Premium, run giveaways, top up GRAM (ex TON) and Ads balances, manage anonymous numbers, and search Fragment listings.

Disclaimer: This project is not affiliated with Fragment or Telegram.

Features

• Purchase Telegram Stars and Premium for any user
• Run Stars and Premium giveaways for channels
• Top up GRAM (ex TON) balance and recharge Telegram Ads
• Manage anonymous numbers (login codes, session termination)
• Search marketplace for usernames, numbers, and gifts
• Fetch wallet info (address, state, GRAM & USDT balances)
• Raw Fragment API calls for advanced use cases
• Browser cookie extraction (Chrome, Firefox, Edge)
• Three blockchain API providers: liteclient (ADNL, no API key), tonapi, toncenter

Installation

go get github.com/Locon213/gofragment

Quick Start

package main

import (
    "context"
    "fmt"
    "log"

    gofragment "github.com/Locon213/gofragment"
)

func main() {
    client, err := gofragment.NewClient(
        "word1 word2 ... word24",
        "YOUR_API_KEY",
        map[string]string{
            "stel_ssid":      "...",
            "stel_dt":        "...",
            "stel_token":     "...",
            "stel_ton_token": "...",
        },
        gofragment.WithAPIProvider(gofragment.ProviderTonapi),
        gofragment.WithWalletVersion(gofragment.WalletV5R1),
    )
    if err != nil {
        log.Fatal(err)
    }
    defer client.Close()

    wallet, err := client.GetWallet(context.Background())
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("GRAM: %.4f | USDT: %.4f\n", wallet.GramBalance, wallet.USDTBalance)

    stars, err := client.PurchaseStars(context.Background(),
        "@username", 500,
        gofragment.WithPaymentMethod(gofragment.PayGRAM),
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Sent %d Stars | tx: %s\n", stars.Amount, stars.TransactionID)
}

Configuration

Blockchain Providers

• liteclient — Direct ADNL connection to TON lite servers. No API key needed. Fastest.
• tonapi — HTTP REST API via tonapi.io. Requires API key from tonconsole.com.
• toncenter — HTTP REST API via toncenter.com. Requires API key from @t.me/toncenter.

Credentials

Fragment cookies: Log in to fragment.com and extract cookies (stel_ssid, stel_dt, stel_token, stel_ton_token).

Automatically from browser:

cookies, err := gofragment.GetCookiesFromBrowser("chrome")

Seed phrase: 12- or 24-word mnemonic from your GRAM (ex TON) wallet.

API Reference

Client Methods

Error Types

All errors implement the error interface and support errors.Is / errors.As:

License

MIT