Rate limits

Plan	Applies to	Minute limit	Daily limit	Keyed by
Free	`/api/v1/public/*`	50 requests / 10 seconds	—	Client IP at the edge
Pro	Authenticated realtime API	30 requests/minute	20,000/day	Clerk organization
Premium	Authenticated realtime API	180 requests/minute	150,000/day	Clerk organization

Paid limits are organization-wide. Every API key and authenticated session in an organization draws from the same budgets, so creating more keys does not increase throughput. The daily budget resets at 00:00 UTC.

Public requests are limited and cached at the Cloudflare edge and are not double-counted by the application limiter.

An authenticated organization without a paid plan has no organization budget. Those requests are held to a per-key minute ceiling instead, an abuse baseline rather than a plan allowance, so they carry the minute headers below but no daily ones.

Response headers

Paid (Pro and Premium) responses carry both budgets:

Header	Meaning
`RateLimit-Limit`	Plan requests per minute.
`RateLimit-Remaining`	Requests left in the current minute.
`RateLimit-Reset`	Seconds until the minute counter resets.
`RateLimit-Daily-Limit`	Plan requests per UTC day.
`RateLimit-Daily-Remaining`	Requests left today.
`RateLimit-Daily-Reset`	Seconds until 00:00 UTC.

Unpaid authenticated responses carry only the three minute headers, since there is no daily budget to report.

An over-limit request returns 429 Too Many Requests, the same headers with the exhausted remaining value at zero, and Retry-After for the binding budget:

123456{
  "error": "rate_limited",
  "limit": "rpm",
  "message": "Organization rpm request limit exceeded; retry after 18s.",
  "upgrade_url": "https://adjacent.markets/subscribe"
}

Back off for at least Retry-After seconds. upgrade_url points at the plan catalog, where a larger allowance can be bought; it is omitted when no plan is available to buy.

You can also see the live minute and daily meters under Settings → Billing & usage before a 429 occurs.

No plan at all

A 429 means a plan's budget ran out. A request from an organization with no paid plan is refused up front instead, with 403 Forbidden:

12345{
  "error": "Insufficient scope: a Pro or Premium API plan is required",
  "status": 403,
  "upgrade_url": "https://adjacent.markets/subscribe"
}

upgrade_url carries the same meaning as on a 429 and is likewise omitted when no plan is available to buy. Unlike a 429 this is not worth retrying: nothing resets, and the request succeeds only once the organization holds a plan.