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

cd api-cost-tracker
npm install

Quick Start

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

{
  "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:

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

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

node scripts/main.mjs budget set 100 --monthly
node scripts/main.mjs alerts enable

Export Monthly Report

node scripts/main.mjs export --format markdown --period month --output monthly-report.md

Compare Models

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:

Every 6 hours:
- Run: node /path/to/api-cost-tracker/scripts/main.mjs track
- Alert if budget > 75%

Automated Budget Monitoring

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

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:

{
  "webhooks": [
    {
      "url": "https://your-slack-webhook.com",
      "events": ["budget_exceeded", "high_usage"]
    }
  ]
}

Historical Analysis

# 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

# Test API keys
node scripts/main.mjs test-keys

Missing Data

# Rebuild database
node scripts/main.mjs rebuild

Testing

npm test

api-cost-tracker

Safety Notice

Copy this and send it to your AI assistant to learn