api-cost-tracker

# API Cost Tracker 💰 Comprehensive AI API cost tracking across multiple providers. Monitor spending, set budgets, get alerts, and optimize your AI costs. ## Features - ✅ **Multi-Provider Support** - OpenAI, Anthropic, Google AI - ✅ **Real-Time Tracking** - Monitor costs as they happen - ✅ **Budget Alerts** - Get notified when approaching limits - ✅ **Usage Analytics** - Detailed insights into API usage - ✅ **Cost Optimization** - Tips to reduce spending - ✅ **Export Reports** - JSON, CSV, Markdown formats - ✅ **Historical Data** - Track costs over time - ✅ **Model Comparison** - Compare costs across models ## Installation ```bash cd api-cost-tracker npm install ``` ## Quick Start ```bash # Track all providers node scripts/main.mjs track # Track specific provider node scripts/main.mjs track --provider openai # View analytics node scripts/main.mjs analytics # Set budget node scripts/main.mjs budget set 100 --monthly # Export report node scripts/main.mjs export --format markdown --output report.md ``` ## Configuration Edit `config.json`: ```json { "providers": { "openai": { "enabled": true, "apiKey": "${OPENAI_API_KEY}" }, "anthropic": { "enabled": true, "apiKey": "${ANTHROPIC_API_KEY}" }, "google": { "enabled": true, "apiKey": "${GOOGLE_AI_KEY}" } }, "budgets": { "daily": 10, "weekly": 50, "monthly": 200 }, "alerts": { "enabled": true, "thresholds": [50, 75, 90, 100], "webhook": "https://your-webhook.com/alert" }, "tracking": { "autoTrack": true, "interval": 300000 } } ``` ## API Reference ### `track(options)` Track API usage and costs. **Options:** - `provider` (string): Specific provider or 'all' - `period` (string): 'today', 'week', 'month', 'all' **Returns:** ```json { "total": 45.67, "providers": { "openai": 32.10, "anthropic": 10.50, "google": 3.07 }, "models": { "gpt-4": 28.50, "claude-3": 10.50 } } ``` ### `analytics(period)` Get detailed analytics. **Period:** 'day', 'week', 'month', 'year' **Returns:** - Cost trends - Usage patterns - Model efficiency - Optimization suggestions ### `budget.set(amount, period)` Set budget limit. ### `budget.check()` Check current budget status. ### `export(format, options)` Export cost report. **Formats:** 'json', 'csv', 'markdown' ## Usage Examples ### Track Daily Costs ```bash node scripts/main.mjs track --period today ``` Output: ``` 💰 API Costs - Today ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ OpenAI GPT-4: $12.50 (125K tokens) GPT-3.5: $2.30 (230K tokens) Subtotal: $14.80 Anthropic Claude-3: $8.20 (82K tokens) Subtotal: $8.20 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Total: $23.00 Budget: $200/month (11.5% used) ``` ### Set Budget Alert ```bash node scripts/main.mjs budget set 100 --monthly node scripts/main.mjs alerts enable ``` ### Export Monthly Report ```bash node scripts/main.mjs export --format markdown --period month --output monthly-report.md ``` ### Compare Models ```bash node scripts/main.mjs compare --models gpt-4,claude-3,gemini-pro ``` ## Pricing Reference ### OpenAI (per 1K tokens) - GPT-4: $0.03 (input) / $0.06 (output) - GPT-4 Turbo: $0.01 / $0.03 - GPT-3.5 Turbo: $0.0005 / $0.0015 ### Anthropic (per 1K tokens) - Claude-3 Opus: $0.015 / $0.075 - Claude-3 Sonnet: $0.003 / $0.015 - Claude-3 Haiku: $0.00025 / $0.00125 ### Google AI (per 1K tokens) - Gemini Pro: $0.00025 / $0.0005 - Gemini Ultra: $0.0025 / $0.0075 ## Integration with OpenClaw Add to your HEARTBEAT.md for automated tracking: ```markdown Every 6 hours: - Run: node /path/to/api-cost-tracker/scripts/main.mjs track - Alert if budget > 75% ``` ### Automated Budget Monitoring ```bash # Add to crontab 0 */6 * * * cd /path/to/api-cost-tracker && node scripts/main.mjs check-budget ``` ## Advanced Features ### Cost Optimization Tips Run optimization analysis: ```bash node scripts/main.mjs optimize ``` Get suggestions like: - Switch to GPT-3.5 for simple tasks - Use Claude-3 Haiku for fast responses - Batch requests to reduce API calls - Cache common responses ### Webhook Integration Configure alerts to send to webhooks: ```json { "webhooks": [ { "url": "https://your-slack-webhook.com", "events": ["budget_exceeded", "high_usage"] } ] } ``` ### Historical Analysis ```bash # View last 30 days node scripts/main.mjs history --days 30 # Compare months node scripts/main.mjs compare --period month --previous ``` ## Data Storage Cost data is stored locally: ``` data/ ├── costs/ │ ├── 2026-03-01.json │ ├── 2026-03-02.json │ └── ... ├── budgets.json └── alerts.log ``` ## Troubleshooting ### API Key Issues ```bash # Test API keys node scripts/main.mjs test-keys ``` ### Missing Data ```bash # Rebuild database node scripts/main.mjs rebuild ``` ## Testing ```bash npm test ``` ## License MIT - Free for personal and commercial use. ## Support - GitHub Issues: [your-repo] - OpenClaw Discord: https://discord.gg/clawd ## Roadmap - [ ] More providers (Cohere, AI21, etc.) - [ ] Real-time dashboard - [ ] Team cost sharing - [ ] Custom pricing rules - [ ] Predictive analytics