# Fragment Stars API

> API for buying Telegram Stars and Telegram Premium subscriptions through Fragment.com using TON wallets. KYC mode is permanently free with 0% API commission when the client provides their own Fragment cookies.

Primary docs: https://wemakecode.ru/fragment-api
Production API endpoint: https://fragment-api.ydns.eu:8443
Python SDK: https://pypi.org/project/fragment-stars-api/
GitHub SDK repo: https://github.com/bbbuilt/fragment-stars-api
Example Telegram shop: https://github.com/bbbuilt/tg_stars_premium_shop
OpenAPI spec: https://wemakecode.ru/fragment-api/openapi.yaml
Full AI context: https://wemakecode.ru/fragment-api/llms-full.txt

## Core Rules For AI Agents

- Normal client API calls do not require issued API tokens, X-API-Key, JWT, OAuth, or Authorization headers.
- Admin endpoints are separate and use X-Admin-Key; never ask normal API clients for this key.
- Wallet seed, Fragment cookies, and Fragment localStorage are secrets and must stay backend-only.
- Do not put wallet seed or Fragment cookies in frontend/browser code.
- KYC mode is free forever: 0% API commission when fragment_cookies are provided.
- Clients may call GET /api/v1/commission/rates or SDK get_rates() before use if they want to verify rates.
- Do not blindly retry a purchase after transaction signing/sending may have happened; this can create duplicate purchases.

## Common Endpoints

- GET /health
- GET /api/v1/prices
- GET /api/v1/commission/rates
- POST /api/v1/stars/buy
- POST /api/v1/premium/buy
- GET /api/v1/queue/{request_id}
- GET /api/v1/queue/status

## Python SDK Quick Start

```bash
pip install fragment-stars-api
```

```python
from fragment_api import FragmentAPIClient

client = FragmentAPIClient("https://fragment-api.ydns.eu:8443")
rates = client.get_rates()
```