> ## 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

> [card] Free — \$0 / mo
>
> Data for 50 users. 1 request per second.

> [card] Starter — \$49 / mo
>
> Data for 200 users. 5 requests per second. \$468 per year.

> [card] Pro — \$149 / mo
>
> Data for 500 users. 10 requests per second. Live WebSocket stream. \$1,428 per year.

> [card] Business — \$499 / mo
>
> Data for 1,000 users. 25 requests per second. Live WebSocket stream. \$4,788 per year.

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 trades stream ([/v1/stream](https://docs.cabalspy.xyz/cabalspy-id/stream.md)) | 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 |
| White-Label and trading competitions | Yes | Yes | Yes | Yes | Yes |
| Trade Feed and copy trading (API, streams, webhooks) | Yes | Yes | Yes | Yes | Yes |
| Callouts and callout competitions | On request | On request | On request | On request | On request |

Instances in development or sandbox mode are limited to 1 request per second and 25 users, and include the live trades stream for testing. The theses, Trade Feed, copy trading and callouts streams are on every plan.

## 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.

> [!NOTE]
>
> White-Label: platform users you add count the same way, but over the limit a new user is refused with `plan_user_limit` instead of being created without data. Existing users keep working.

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](https://docs.cabalspy.xyz/cabalspy-id/me.md) shows how many users you currently receive data for.

## White-Label

[White-Label](https://docs.cabalspy.xyz/cabalspy-id/white-label.md) is available on every plan. Platform users you add through the API count against the same user limit as people who sign in with CabalSpy ID: on a live instance, every platform user takes a seat of your domain's plan. When all seats are taken, new platform users are refused with `plan_user_limit`; existing ones can still be updated. Sandbox and development instances can hold 25 platform users.

On every plan, a developer account can run up to 5 [trading competitions](https://docs.cabalspy.xyz/cabalspy-id/competitions.md) at the same time (scheduled and running together).

## Extras on request

[Callouts](https://docs.cabalspy.xyz/cabalspy-id/callouts.md) are an extra that CabalSpy switches on per instance on request, on any plan: your users call tokens, CabalSpy ID tracks them and you get stats, a leaderboard, a live stream, webhooks and [callout competitions](https://docs.cabalspy.xyz/cabalspy-id/competitions-callouts.md). Contact us at [contact@cabalspy.xyz](mailto:contact@cabalspy.xyz) to enable them. [GET /v1/me](https://docs.cabalspy.xyz/cabalspy-id/me.md) lists the extras of your instance in `features`.

## 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.