Skip to content

bes-dev/telegram_stars_rates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⭐ Telegram Stars Rates

PyPI version Python versions License: Apache 2.0

Real-time Telegram Stars to USDT exchange rates via Fragment blockchain analysis

πŸš€ Features

  • 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

πŸ“¦ Installation

pip install telegram-stars-rates

πŸ’» Usage

Python API

from 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")

CLI Tool

# 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_KEY

Web Interface

Visit the GitHub Pages site for an interactive converter:

  • Real-time rates updated daily
  • Convert between Stars ↔ USDT
  • Exchange rate statistics
  • Mobile-friendly interface

Public API Endpoints

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" }

πŸ”§ How It Works

  1. Fragment Analysis: Fetches real transactions from Fragment's TON address
  2. Rate Calculation: Parses "X Telegram Stars" β†’ TON transfers
  3. USDT Conversion: Gets TON/USDT rate from Binance API
  4. Final Rate: Calculates Stars β†’ USDT via Stars β†’ TON β†’ USDT

πŸ“Š API Reference

get_stars_rate(limit=50, include_raw=False, **kwargs)

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 }

🌍 GitHub Actions Integration

Automated daily updates for GitHub Pages:

- name: Update Exchange Rates run: |  python scripts/generate_rates.py  # Deploys to GitHub Pages automatically

πŸ›  Development

git 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.py

πŸ“„ License

Apache 2.0 License - see LICENSE file for details.

πŸ”— Links

🀝 Contributing

We welcome contributions to this project!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“Š Statistics

GitHub stars GitHub forks PyPI downloads


πŸ’Ž Professional Telegram Stars exchange rate analysis for Python developers! πŸ’Ž

About

Simple Python library to convert Telegram Stars <-> USDT

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors