🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

API Cost Tracker

by @k5rs4n

Track AI API costs across OpenAI, Anthropic, Google AI with budget alerts, analytics, and optimization tips

Versionv1.0.0
Downloads768
Installs2
TERMINAL
clawhub install api-cost-tracker

πŸ“– About This Skill


name: api-cost-tracker description: "Track AI API costs across OpenAI, Anthropic, Google AI with budget alerts, analytics, and optimization tips" metadata: clawdbot: emoji: πŸ’° requires: env: - OPENAI_API_KEY (optional) - ANTHROPIC_API_KEY (optional) - GOOGLE_AI_KEY (optional)

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
    

    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
  • πŸ’‘ Examples

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

    πŸ“‹ Tips & Best Practices

    API Key Issues

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

    Missing Data

    # Rebuild database
    node scripts/main.mjs rebuild