Quickstart

Get QuotaWatch monitoring your API calls in under 5 minutes.

1. Create your account

Sign up at quotawatch.app/register. Create a project in the dashboard, then generate an API key from Settings → API Keys.

2. Install the SDK

Node.js / TypeScript

npm install quotawatch
# or
pnpm add quotawatch
# or
yarn add quotawatch

Python

pip install quotawatch

3. Initialize in your app

Call QuotaWatch.init() once at application startup — before any API calls are made.

Node.js

index.tstypescript
import { QuotaWatch } from 'quotawatch';

QuotaWatch.init({
  apiKey: 'qw_live_your_key_here',
  ingestUrl: 'https://ingest.quotawatch.app', // use http://localhost:3001 for local dev
  environment: 'production',
  apis: [
    {
      name: 'OpenAI',
      baseUrl: 'https://api.openai.com',
      limits: {
        requestsPerMinute: 60,
        requestsPerDay: 10000,
      },
    },
    {
      name: 'Stripe',
      baseUrl: 'https://api.stripe.com',
      limits: {
        requestsPerDay: 5000,
      },
    },
  ],
});

// That's it. All fetch() calls to configured APIs are now monitored.

Python

main.pypython
from quotawatch import QuotaWatch
from quotawatch.types import QuotaWatchConfig, ApiConfig, ApiLimits

QuotaWatch.init(QuotaWatchConfig(
    api_key="qw_live_your_key_here",
    ingest_url="https://ingest.quotawatch.app",  # use http://localhost:3001 for local dev
    environment="production",
    apis=[
        ApiConfig(
            name="OpenAI",
            base_url="https://api.openai.com",
            limits=ApiLimits(
                requests_per_minute=60,
                requests_per_day=10000,
            ),
        ),
        ApiConfig(
            name="Stripe",
            base_url="https://api.stripe.com",
            limits=ApiLimits(requests_per_day=5000),
        ),
    ],
))

# All requests.get/post/etc to configured APIs are now monitored.
💡
No code changes needed beyond init. The SDK wraps your existing HTTP client transparently — your app code stays exactly the same.
💡
On the free plan, only 1 project, 1 environment, and 1 API are tracked per project. Events outside these limits are rejected with HTTP 403. Upgrade to Pro or Team for higher limits — see the configuration docs for details.

4. View your dashboard

Open the dashboard. Within seconds of your first API call, you'll see usage cards appear. Data is aggregated in real time — no delay, no batch jobs.

5. Set up alerts (optional)

Go to Settings → Email Alertsand configure threshold alerts at 80% and 95% of your limits. You'll get an email before the 429s hit.

⚠️
Alerts require a Resend API key to be configured.
Node.js SDK reference →