> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Metering

> Track and monitor API usage across your Grantex deployment

## Overview

Grantex tracks API usage in real-time using Redis counters with periodic PostgreSQL rollup. Monitor token exchanges, authorizations, and verifications per developer.

## Enabling Usage Metering

Set the environment variable:

```bash theme={null}
USAGE_METERING_ENABLED=true
```

## API Endpoints

### Current Period Usage

```bash theme={null}
curl https://api.grantex.dev/v1/usage \
  -H "Authorization: Bearer $GRANTEX_KEY"
```

Response:

```json theme={null}
{
  "developerId": "dev_...",
  "period": "2026-03-02",
  "tokenExchanges": 42,
  "authorizations": 18,
  "verifications": 7,
  "totalRequests": 67
}
```

### Usage History

```bash theme={null}
curl "https://api.grantex.dev/v1/usage/history?days=30" \
  -H "Authorization: Bearer $GRANTEX_KEY"
```

## SDK Usage

```typescript theme={null}
// TypeScript
const usage = await grantex.usage.current();
console.log(`Today: ${usage.totalRequests} requests`);

const history = await grantex.usage.history({ days: 7 });
for (const day of history.entries) {
  console.log(`${day.date}: ${day.totalRequests}`);
}
```

```python theme={null}
# Python
usage = grantex.usage.current()
print(f"Today: {usage.total_requests} requests")

history = grantex.usage.history(days=7)
for day in history.entries:
    print(f"{day.date}: {day.total_requests}")
```

## Plan Limits

| Metric | Free | Pro | Enterprise |
| - | - | - | - |
| Agents | 500 | 5,000 | Unlimited |
| Grants | 1,000 | 50,000 | Unlimited |
| Policies | 50 | 500 | Unlimited |
| Audit entries | 20,000 | 1,000,000 | Unlimited |
| Token exchanges/month | 50,000 | 5,000,000 | Unlimited |
| Authorizations/month | 50,000 | 5,000,000 | Unlimited |
| Webhooks | 30 | 200 | Unlimited |
| Standard developer API-key throughput/minute | 100 | 500 | 2,000 |

## Ownership

Grantex is owned by Orchestrum Technologies LLP. Inventor and owner: Sanjeev Kumar. Ownership contact: [sanjeev@orchestrum.in](mailto:sanjeev@orchestrum.in) or [mishra.sanjeev@gmail.com](mailto:mishra.sanjeev@gmail.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.