Real-time Telegram Stars to USDT exchange rates via Fragment blockchain analysis
- Real-time Exchange Rates: Get current Stars β USDT rates from Fragment blockchain
- Minimalistic Library: Simple Python API with minimal dependencies
- CLI Tool: Command-line interface for quick rate checks
- Web Converter: GitHub Pages hosted converter with daily updates
- Fragment Integration: Direct blockchain transaction parsing
- Binance API: TON β USDT rates from Binance
pip install telegram-stars-ratesfrom telegram_stars_rates import get_stars_rate # Get current exchange rates result = get_stars_rate() print(f"1 Star = ${result['usdt_per_star']:.6f} USDT") print(f"1000 Stars = ${result['usdt_per_star'] * 1000:.2f} USDT") # With raw transaction data result = get_stars_rate(include_raw=True, limit=100) print(f"Based on {result['fragment_raw']['transactions_count']} transactions")# Basic usage telegram-stars-rates # More transactions for better accuracy telegram-stars-rates --limit 100 # JSON output telegram-stars-rates --json # With TON API key (faster, no rate limits) telegram-stars-rates --api-key YOUR_TON_API_KEYVisit the GitHub Pages site for an interactive converter:
- Real-time rates updated daily
- Convert between Stars β USDT
- Exchange rate statistics
- Mobile-friendly interface
Access live exchange rates via public JSON APIs:
Simple API (recommended):
https://bes-dev.github.io/telegram_stars_rates/api.json Detailed API (with transaction data):
https://bes-dev.github.io/telegram_stars_rates/rates.json Example Response (api.json):
{ "usdt_per_star": 0.015015, "ton_per_star": 0.004354, "usdt_per_ton": 3.449, "timestamp": "2025-08-13T12:59:34Z", "transactions_analyzed": 100, "source": "fragment_blockchain_analysis" }- Fragment Analysis: Fetches real transactions from Fragment's TON address
- Rate Calculation: Parses "X Telegram Stars" β TON transfers
- USDT Conversion: Gets TON/USDT rate from Binance API
- Final Rate: Calculates Stars β USDT via Stars β TON β USDT
Parameters:
limit(int): Number of transactions to analyze (default: 50)include_raw(bool): Include raw transaction data (default: False)api_key(str): TON API key for higher rate limits
Returns:
{ "usdt_per_star": 0.012345, # Main exchange rate "ton_per_star": 0.002500, # Stars β TON rate "usdt_per_ton": 4.938000, # TON β USDT rate "timestamp": "2024-01-01T12:00:00Z", "errors": [] # Any warnings/errors }Automated daily updates for GitHub Pages:
- name: Update Exchange Rates run: | python scripts/generate_rates.py # Deploys to GitHub Pages automaticallygit clone https://github.com/username/telegram-stars-rates cd telegram-stars-rates pip install -e . # Run tests python -m pytest # Generate web data python scripts/generate_rates.pyApache 2.0 License - see LICENSE file for details.
- Fragment: https://fragment.com
- TON API: https://tonapi.io
- Binance API: https://binance.com/api
We welcome contributions to this project!
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
π Professional Telegram Stars exchange rate analysis for Python developers! π