Automated daily TAO earnings reporter for Bittensor miners. Fetches earnings data from the Taostats API and posts summaries to Discord via webhook.

• 📊 Fetches TAO earnings for multiple coldkeys from Taostats accounting API
• 📅 Configurable lookback period (daily, weekly, or all-time)
• 🔄 Supports multiple Bittensor networks (Finney, Nakamoto, Kusanagi)
• 📱 Posts formatted earnings reports to Discord webhook
• ⚙️ Designed for automated execution via GitHub Actions or cron

1. Clone the repository:

git clone https://github.com/yourusername/bittensor-tao-earnings-reporter.git
cd bittensor-tao-earnings-reporter

2. Create a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Create a .env file in the project root:

# Required
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/your-webhook-url
TAOSTATS_API_KEY=your-taostats-api-key
MINER_ADDRESSES=5ABC...,5DEF...,5GHI...

# Optional
TAO_LOOKBACK_DAYS=10          # Days to look back (0 = all time)
TAO_NETWORK=finney            # Network: finney, nakamoto, or kusanagi
TAOSTATS_BASE_URL=https://api.taostats.io/api
DEBUG=false                   # Enable debug mode

python daily_tao_to_discord.py

The repository includes a GitHub Actions workflow that runs automatically.

Limitation: GitHub Actions has a 5-minute minimum for scheduled workflows.

Setup:

1. Add GitHub Secrets:

   • Go to your repository → Settings → Secrets and variables → Actions
   • Add the following secrets:
     • DISCORD_WEBHOOK_URL - Your Discord webhook URL
     • TAOSTATS_API_KEY - Your Taostats API key
     • MINER_ADDRESSES - Comma-separated coldkey addresses
     • TAO_LOOKBACK_DAYS (optional) - Default: 10
     • TAO_NETWORK (optional) - Default: finney
     • DEBUG (optional) - Default: false

2. Workflow will automatically:

   • Run every 5 minutes (GitHub minimum)
   • Fetch earnings data
   • Post to Discord webhook

3. Manual trigger:

   • Go to Actions tab → TAO Earnings Discord Reporter → Run workflow

For true 2-minute intervals, use a cron job on your server:

1. Set up environment variables in your .env file (see Configuration section)

2. Add to crontab:

   crontab -e
   # Add this line:
   */2 * * * * /path/to/daily-tao-script/cron-2min.sh

3. Or use the provided script:

   chmod +x cron-2min.sh
   # Then add to crontab:
   */2 * * * * /full/path/to/cron-2min.sh >> /var/log/tao-reporter.log 2>&1

Note: See .github/SECRETS_SETUP.md for detailed GitHub Secrets setup instructions.

• Python 3.9+
• python-dotenv (optional, for .env file support)