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

# Tokonomics Free and Pro Plans: Features and Limits

> Compare the Tokonomics Free and Pro plans — from proxy call limits and API key counts to data retention, analytics API access, and hard spending caps.

Tokonomics offers two plans: a **Free** tier that lets you start metering AI costs with zero commitment, and a **Pro** tier built for production workloads where you need unlimited throughput, multi-team cost tracking, hard spending caps, and API-level access to your analytics data.

## Plan comparison

| Feature              | Free                        | Pro (\$49/month)             |
| -------------------- | --------------------------- | ---------------------------- |
| Monthly proxy calls  | 100                         | Unlimited                    |
| API keys             | 1                           | Unlimited                    |
| Budget alerts        | 1                           | Unlimited                    |
| Alert channels       | Email                       | Email, Slack, Teams, Webhook |
| Hard spending caps   | ✗                           | ✓                            |
| Tag-based analytics  | ✗                           | ✓                            |
| Analytics REST API   | ✗                           | ✓                            |
| Data retention       | 30 days                     | 90 days                      |
| Providers            | OpenAI, Anthropic, DeepSeek | All 9 providers              |
| Credit card required | No                          | Yes                          |

## Free plan

The Free plan is designed for **prototyping, personal projects, and early-stage exploration**. You get 100 proxied requests per month, a single API key, and access to three of the most popular providers — OpenAI, Anthropic, and DeepSeek — with no credit card required.

<CardGroup cols={1}>
  <Card title="Free plan highlights" icon="seedling">
    * **No credit card required** — sign up and start proxying in minutes
    * **30-day cost history** — review your last month of token spend in the dashboard
    * **1 budget alert** — get notified by email when you approach a spending threshold
    * **Access to OpenAI, Anthropic, and DeepSeek** — covers the most widely-used models for development and testing
  </Card>
</CardGroup>

## Pro plan

The Pro plan is built for **production applications, multi-team organisations, agencies, and SaaS builders** who need reliable, unlimited proxying with deep cost visibility. At \$49/month you unlock every provider, unlimited API keys and alerts, and the two features that set Pro apart:

<CardGroup cols={2}>
  <Card title="Hard spending caps" icon="shield-halved">
    Set a maximum dollar amount per API key, per tag, or across your entire account. When the cap is reached, Tokonomics stops forwarding requests and returns a `429` — so you never receive a surprise bill, even if a runaway process burns through tokens overnight.
  </Card>

  <Card title="Analytics REST API" icon="chart-line">
    Query your full cost and usage data programmatically. Build internal dashboards, push spend data into your own data warehouse, or create per-customer billing reports without ever opening the Tokonomics UI.
  </Card>
</CardGroup>

Pro also extends your data retention to **90 days**, lets you route alerts to Slack, Microsoft Teams, or any webhook endpoint, and gives you access to **tag-based analytics** — so you can slice spend by team, feature, environment, tenant, or any other dimension you tag at request time.

## Usage limits

<Tabs>
  <Tab title="Free plan limits">
    When you exhaust your **100 monthly proxy calls** on the Free plan, Tokonomics stops forwarding new requests for the remainder of the calendar month. Your application will receive the following error response:

    ```json theme={null}
    {
      "error": {
        "code": "plan_limit_exceeded",
        "message": "You have reached the 100-request limit for the Free plan. Upgrade to Pro for unlimited proxy calls."
      }
    }
    ```

    Existing API keys and dashboard access remain active — only proxying is paused. Your call count resets on the first day of the next calendar month.
  </Tab>

  <Tab title="Pro plan limits">
    The Pro plan has **no monthly proxy call limit**. You can make as many requests as your workload requires.

    Per-minute rate limits still apply to prevent abuse — see the [Headers reference](/reference/metering-headers) for details on the `X-RateLimit-*` response headers. If you need a higher per-minute limit, contact support.
  </Tab>
</Tabs>

<Note>
  You can upgrade from Free to Pro at any time directly from your [Tokonomics dashboard](https://tokonomics.ca/dashboard). Pro billing is monthly and you can cancel at any time — if you cancel, your plan stays active until the end of the current billing period, then reverts to Free.

  Visit the [live pricing page](https://tokonomics.ca/pricing) for the latest plan details and any current promotions.
</Note>