OpenRouter Cost Tracker

SKILL.md

---
name: openrouter-cost-tracker
description: |
  Check OpenRouter API usage and costs. Shows daily usage, trends, and cost breakdown
  between platform costs and BYOK (Bring Your Own Key) costs. Reads API key from environment.
  Usage: "my openrouter costs"
tags: [openrouter, costs, api, monitoring]
---

# OpenRouter Cost Tracker

Fetch your OpenRouter API usage and cost data with detailed breakdowns.

## Prerequisites

1. **Environment Variable:** Your OpenRouter API key must be set:
   ```bash
   export OPENROUTER_API_KEY="sk-or-v1-..."
   ```
   
   The skill **automatically reads** this from the environment. No manual input required.

2. **Python Module:** Requires `requests` module:
   ```bash
   pip install requests
   ```

## Time Zones (Important!)

**All time periods shown are in UTC, not your local timezone.**

| Display | Meaning | UTC Reference |
|---------|---------|---------------|
| "Last 24h" | Rolling 24-hour window | Last 24 hours from current UTC time |
| "Last 7 days" | 7-day period | UTC midnight to UTC midnight |
| "Month to date" | Since 1st of month | Based on UTC calendar |

## Example Queries

- "what are my openrouter costs"
- "check my openrouter usage"
- "openrouter spending this month"

## Troubleshooting

| Error | Solution |
|-------|----------|
| "OPENROUTER_API_KEY not found" | Set environment variable |
| "API returned 401" | Invalid/expired key |
| "requests module not found" | Run: `pip install requests` |