mrkeyoor.com_
Wed 23 Sept 06:48 UTC
Automationevaluationupdated 23 Sept 2026

fragment-api-dev review

Fragment API Dev is an English-language client and hosted API for buying Telegram Stars or Premium with GRAM or USDT on TON. It gives shops and bots a short Python or REST flow, but each purchase sends wallet signing material to a server operated outside your infrastructure.

Verdict

Our 3-CPU, 8 GB sandbox could not run commit 7500f0c because the repository has no supported project ecosystem or Dockerfile, leaving its paid purchase path unverified by our lab. The client has sensible order-state handling, but sending a wallet seed to a closed hosted service is too much trust for a general treasury wallet. Use it only with an isolated, low-balance wallet after accepting that boundary; otherwise buy through Fragment or operate an inspectable client yourself.

We ran it

Screenshot of fragment-api-dev (pypi.org/project/fragment-api-dev)

Answers from our run

Did you run fragment-api-dev yourself?

No. GitHub reports no primary language for it, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use fragment-api-dev?

Teams that cannot send a 24-word mnemonic or 32-byte private key to a third-party host: the purchase schema requires seed, and the SDK posts it to api-stars.duckdns.org.

What are the alternatives to fragment-api-dev?

Fragment, Fragment API Python SDK, Telegram Bot API. The client has sensible order-state handling, but sending a wallet seed to a closed hosted service is too much trust for a general treasury wallet.

Setup2/5Short client flow, but purchases depend on a remote seed-handling API
Docs4/5Good examples and OpenAPI; server custody details are missing
Community2/5104 stars, three commits, and no open issues or PRs
Maturity1/5No lab run, no GitHub release, and no public server code

Who it’s for

Backend developers automating 50-Star or larger Telegram purchases from an isolated TON wallet.
Shops prepared to reconcile customer payment with an asynchronous blockchain purchase.
Python teams that want a small synchronous client with no third-party package dependencies.
Codex or Claude Code users who want an integration skill covering availability checks and retry rules.

Who it’s NOT for

Teams that cannot send a 24-word mnemonic or 32-byte private key to a third-party host: the purchase schema requires seed, and the SDK posts it to api-stars.duckdns.org.
Operators who need to inspect or self-host the purchase service: the repository publishes examples and an API contract, but no server implementation.
High-value wallets that also hold unrelated funds: the README accepts wallet credentials, so the service receives authority that should not extend to a general treasury.
Buyers who require a documented service commitment or release process: the API documents 429 and 503 responses, while GitHub has no tagged release and no server operations policy.

Setup reality

We did not run commit 7500f0c in our sandbox because the repository has no supported language ecosystem and no Dockerfile. There is no lab result for install, build, or tests; the checkout is an integration-document repository rather than a runnable server project.

Actual purchases need the hosted api-stars.duckdns.org service plus a TON wallet seed or Base64 private key. A 12-word seed also needs a wallet address or account index. USDT purchases still require GRAM for network fees, and wallet material belongs only in backend secret storage.

Availability checks are point-in-time results, not reservations. Production code must reuse one idempotency key per order, persist the purchase ID, poll to a final state, respect 429 and 503 responses, and stop for manual handling when the API returns reconciliation_required.

The short API call hands wallet authority to a remote service

Fragment API Dev 1.3.0 sends the wallet seed in a JSON request to api-stars.duckdns.org, a service you do not operate. One Python call can buy Telegram Stars or Premium and then poll for completion, which makes the convenience easy to see. The same request may carry a 24-word mnemonic or a Base64 32-byte private key. This is a wallet-custody decision dressed as an SDK choice.

The purchase flow itself is restrained. You check whether a username can receive the product, accept the customer's payment only after a positive result, submit one order, save its purchase ID, and poll until it completes or fails. Stars can range from 50 to 1,000,000, while Premium accepts 3, 6, or 12 months. GRAM and USDT on TON are supported, though a USDT purchase still needs some GRAM for network fees.

The 25-path repository omits the purchase server

GitHub lists 21 files across 25 public paths at commit 7500f0c, including a README, an OpenAPI contract, small Python and Node examples, and a portable integration skill for Codex or Claude Code. It does not contain the hosted service implementation. You can inspect the request contract and recommended order logic, but you cannot inspect how the server stores, uses, logs, or deletes the wallet material it receives. There is also no Dockerfile or self-hosting path.

The separately published PyPI 1.3.0 source archive does include the Python client, even though that client code is absent from the GitHub checkout. It uses Python's standard library, validates usernames and purchase amounts locally, maps 400, 409, 429, and 503 responses to named errors, and creates an idempotency value when the caller omits one. That is useful client behavior. It still delegates the valuable operation, signing and submitting a purchase, to the closed server.

What happened when we ran it

Our 3-CPU, 8 GB sandbox did not run fragment-api-dev. We cloned commit 7500f0c on September 16, 2026, then measured the checkout as having no supported language ecosystem and no Dockerfile. Under our test method, that leaves no install time, build result, dependency count, test result, or vulnerability audit to report. Claiming that the package passed would turn an absent run into invented evidence.

Our read-only check of the documented host returned HTTP 200 on September 23, but a health response does not exercise wallet derivation, payment, delivery, retries, or reconciliation. We did not send a seed, create an order, or spend funds. The paid path remains outside our measurement. That boundary matches the repository tree: this is an integration kit, not the source for a runnable API service.

Version 1.3.0 requires a wallet seed for purchases

The 1.3.0 OpenAPI schema makes seed mandatory for a purchase. The client strips it, places it in the request body, and sends it over HTTPS to the hosted endpoint. A 12-word mnemonic also needs an address or account index; the service offers a resolver that receives the seed too. The repository warns against browser storage, logs, fixtures, and public issues, but transport security does not answer what happens after the server receives the credential.

The 168-byte SECURITY.md gives a Telegram contact for private reports and does not publish a data-retention policy. No server code explains whether seeds stay only in memory, reach application logs, enter a queue, or survive a failed order. For a wallet funded only with the exact amount needed for a purchase, you can bound the damage. Sending the mnemonic of a treasury or long-lived wallet would give an unaudited service far more authority than this convenience warrants.

The 1.3.0 client prevents blind order replacement

The 1.3.0 client creates an idempotency value when the caller omits one, while the integration guide tells shops to derive a stable value from their own order ID and reuse it on retries. After the API accepts a purchase, the caller saves the returned ID before polling. Only completed means success. A reconciliation_required result must stop automatic replacement, because buying again after an unclear blockchain response can charge the wallet twice.

Availability has similarly careful wording. Its result is a current check, not a price reservation or delivery promise. The docs tell callers to pause on 429, retry later on 503, and avoid charging a customer when eligibility cannot be confirmed. Those rules belong in persistent application state, not a request handler that forgets everything after a timeout. The examples are enough to design that state machine, though they cannot promise the hosted service will stay available.

Three commits are too little history for a funded wallet

GitHub shows 104 stars, 10 forks, and 0 combined open issues and pull requests. The repository was created on August 30, 2026, received its third commit on September 2, and has no GitHub release. PyPI reached 1.3.0 on September 2. This is recent activity rather than abandonment, but it provides only a short public record for software entrusted with transferable credentials and paid orders.

A 50-Star trial with an isolated wallet is the most defensible starting point. Persist every purchase state, cap its balance, and plan manual reconciliation before increasing volume. If you are unwilling to let this operator receive signing material for even that wallet, the clean client API does not compensate for the missing trust evidence.

Alternatives

ProjectWhat it isPick it when
FragmentTelegram's official marketplace provides a manual route for Stars and Premium purchases.pick this instead when purchase volume is low and you prefer the official interface to a third-party automation service.
Fragment API Python SDKAn async Python client that exposes Fragment marketplace and purchase operations from inspectable source.pick this instead when you can manage Fragment cookies or a MarketApp token and want the client logic in your own process.
Telegram Bot APITelegram's self-hostable Bot API server supports bot payment flows, including Telegram Stars.pick this instead when your actual job is charging users inside a bot rather than buying Stars for another account.

What people are saying

  1. [velocity-scout] slightbasebo/fragment-api-dev

Sources

  1. Fragment API Dev README
  2. Fragment API OpenAPI contract
  3. Fragment API integration skill
  4. fragment-api-dev on PyPI
  5. Telegram Bot API server

More automation reviews

FreePEP · undress-service · fullsend · linkedin-skills · ax · newsjack · the whole board →