What is the Telegram Stars API and what problem does it solve?
Telegram Stars are the main payment unit for in-bot services, digital content and subscriptions. For a reseller, bot owner or automated store, fulfilling each order by hand takes time and increases the chance of mistakes.
The Telegram Stars API turns this process into a single automated flow: a customer request comes in, the system checks it, fulfils the order and returns the result. No operator needed, at any time of day.
- Removes manual processing entirely
- Reduces human error and the risk of mistakes
- 24/7 automated sales flow
- The history and status of every order are recorded
How does the order flow work?
A Stars order consists of a few clear steps. First the recipient is checked by Telegram username, then the current price from Fragment.com is fetched and the project balance is checked.
If the conditions are met, payment is automatically deducted from the project account and the order is completed. The result is returned in the API response right away and written to the dashboard statistics.
- getInfo — check a user by username
- stars/pricing — current price for the chosen amount
- stars/buy — fulfil the order automatically
- wallet/balance — monitor the project balance
Main endpoints
The integration uses REST and JSON. The project's secret API key is added to every request via the X-API-Key header, and the base path is /api/v1.
Use /api/v1/getInfo to check a user, /api/v1/stars/pricing to get a price and /api/v1/stars/buy to fulfil an order. For balance and calculations there are /api/v1/wallet/balance and /api/v1/wallet/calculate.
All responses share the same structure: ok (success flag), message (description), code (status code) and result (result). This makes the integration predictable and error handling easy.
How do you get started?
To start, sign up and create a project, get its API key and set up the project balance for fulfilling orders. After that your bot or backend can send requests to the endpoints.
For every endpoint, the /api docs include full request, response and cURL samples as well as error formats. This lets a developer finish the integration quickly.
- Create a project and name it
- Get the API key and keep it safe
- Set up the project balance
- Send a first test order and check the response
Who is it for?
The solution suits Telegram Stars resellers, bot owners, marketplaces and SMM panels, as well as developers who want to serve their customers automatically.
If you take orders through an API, Fragment-API.uz lets you build a fully automated sales flow without a dedicated operator. The minimum Stars order is 50 stars.
Frequently asked questions
Do I need to log in to a Telegram account to use the Telegram Stars API?
No. No login is required on the customer side. The project works through an API key, and orders are fulfilled automatically through a server-side integration.
Where does the Stars price come from?
The price comes from Fragment.com's response — the current value at the moment of ordering. So users always see an up-to-date price.
What is the minimum Stars amount?
On the platform, the minimum for a single Stars order is 50 stars.
How does payment work?
Payment is automatically deducted from the project balance. There must be enough funds on the balance for the order to go through; otherwise the request won't be fulfilled.
Where can I see the order status?
The status is returned immediately in the API response (ok, message, code, result) and is also written to the project dashboard statistics.
Can I open several projects?
Yes. Each project has its own name, API key and balance, so it's easy to manage different customers or business lines separately.