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

# Plans and limits

> CabalSpy ID plans per registrable domain: how many users you receive data for, the API request rate, the live stream and what happens above the limit.

CabalSpy ID plans are priced per month and per registrable domain, for example `example.com`, with all its subdomains and live apps counting towards the same plan. The plan sets how many users you receive data for and how fast you can call the Data API. Yearly billing saves 20 percent.

## Plans

<CardGroup cols={2}>
  <Card title="Free — $0 / mo">
    Data for 50 users. 1 request per second.
  </Card>

  <Card title="Starter — $49 / mo">
    Data for 200 users. 5 requests per second. \$468 per year.
  </Card>

  <Card title="Pro — $149 / mo">
    Data for 500 users. 10 requests per second. Live WebSocket stream. \$1,428 per year.
  </Card>

  <Card title="Business — $499 / mo">
    Data for 1,000 users. 25 requests per second. Live WebSocket stream. \$4,788 per year.
  </Card>
</CardGroup>

The **Enterprise** plan adds unlimited users, a custom request rate with an SLA and `scope=global`, access to every CabalSpy ID user. Contact sales at [contact@cabalspy.xyz](mailto:contact@cabalspy.xyz).

## Compare plans

| Feature | Free | Starter | Pro | Business | Enterprise |
| - | - | - | - | - | - |
| Price per month | \$0 | \$49 | \$149 | \$499 | Custom |
| Price per year | – | \$468 | \$1,428 | \$4,788 | Custom |
| Users with data | 50 | 200 | 500 | 1,000 | Unlimited |
| Data API requests per second | 1 | 5 | 10 | 25 | Custom, with SLA |
| Live WebSocket stream | No | No | Yes | Yes | Yes |
| `scope=global` (all CabalSpy ID users) | No | No | No | No | Yes |
| Token theses, widget and theses stream | Yes | Yes | Yes | Yes | Yes |
| Sign-in for everyone | Yes | Yes | Yes | Yes | Yes |

Instances in development or sandbox mode are limited to 1 request per second.

## The user limit

Everyone can always sign in to your platform, the user limit never blocks a sign-in. It decides who you receive data for.

The first users of your domain, counted by their first sign-in across all your live apps, up to your plan's limit, hold a seat. For them you receive the full identity, wallets, trading data and webhooks.

Everyone beyond the limit still signs in, but you only receive an anonymous id that starts with `anon_` and `"limited": true`, with no name, no wallets, no Data API data and no webhooks.

```json theme={null}
{
  "sub": "anon_k3x9w2...",
  "limited": true,
  "reason": "plan_user_limit"
}
```

The Data API answers `plan_user_limit` when you pass such an anonymous id. When a seated user leaves, by removing access, being blocked by you or deleting their account, the seat is freed and the next person moves up. When you upgrade, more users get a seat and receive their real id and data the next time they sign in.

You receive an e-mail when your domain reaches 80 percent and 100 percent of its user limit. [GET /v1/me](/cabalspy-id/me) shows how many users you currently receive data for.

## Rate limits

The request rate is per API key and counted in fixed one-second windows. Every response carries `X-RateLimit-Limit` and `X-RateLimit-Remaining`. Above the limit the API answers `429 rate_limit_exceeded` with `Retry-After: 1`, wait a second and retry.

The live stream allows at most 5 connections per API key.

## Payment and billing

Manage your plan at [apidashboard.cabalspy.xyz/billing/csid](https://apidashboard.cabalspy.xyz/billing/csid). You can pay by card through Stripe or with crypto through MoonPay or Helio. When a paid plan expires, the domain falls back to the Free plan.

The CabalSpy ID plan is separate from your CabalSpy API plan and its credits.


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