# Fragment Stars API

Public API for buying Telegram Stars and Premium through Fragment.com.

- Documentation: https://fragment-api.space/en/docs/
- OpenAPI: https://fragment-api.space/openapi.yaml
- Production API: https://api.fragment-api.space
- Python SDK: https://pypi.org/project/fragment-stars-api/
- Full AI context: https://fragment-api.space/llms-full.txt

## Integration facts

- Public client routes require no issued API key.
- KYC API commission is 0%; no-KYC API commission is 0.25%.
- Verify current rates with `GET /api/v1/commission/rates`.
- Stars purchases start at 50.
- `payment_method` accepts `ton` or `usdt_ton` and defaults to `ton`.
- Wallet seed and Fragment session fields are backend-only secrets. Use the
  `YOUR_BASE64_ENCODED_*` placeholders in examples and never expose real values.
- A 12-word BIP39 seed accepts optional `account_index`, `wallet_address`, or both.
- Use backend-only `POST /api/v1/wallet/resolve` with seed plus `wallet_address`
  to find an account index. Do not put seed data in URL query parameters.
- Prefer `POST /api/v1/stars/buy` and `POST /api/v1/premium/buy` for new integrations.
- A queued Stars response includes `request_id`; poll `GET /api/v1/queue/{request_id}`.
- Do not automatically retry a purchase when its final state is unknown.

## Common public routes

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