Plans, limits & credits

Every plan has a rate limit (requests per second, with a burst of twice that), a monthly credit quota, WebSocket limits and a set of endpoints. Each request costs a number of credits depending on the endpoint; cheap calls such as prices cost 1.

How the rate limit works: each key (or, without a key, each IP address) has a bucket that holds up to twice its per-second limit and refills at that limit. A Free key (10 requests/s) can send 20 requests at once, then 10 every second. The Account API has its own limit and is never counted.

Getting a key or a bigger plan: a Free key takes a minute at dashboard.crius.sh (email or wallet, no card). Upgrades are on the dashboard’s Billing page; for more than Business, write to support@crius.sh.

Plans

Paying for 6 months gives 10% off, and 12 months 20% off. Plans are paid on-chain on Robinhood Chain in USDG, ETH or WETH; see Billing & payments. Credits reset at the start of each UTC month and are shared by all of an account’s keys.

Endpoints by plan

Each endpoint page in the API reference shows its plan and cost. Calls to the Account API (/v1/account/*) are free and don’t count against your credits.

Rate-limit headers

Every data response carries:

When you go over the rate limit you get 429 rate_limited with a retry-after header (seconds). When the month’s credits run out you get 429 quota_exceeded until the next month, or until you upgrade. Both say what your limit is and how to raise it:

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit reached: requests without an API key are limited to 2 per second per IP (bursts of up to 4). Retry in 1 s, or get a free API key (10 requests/s, 1,000,000 credits a month) at https://dashboard.crius.sh.",
    "plan": "anon",
    "limit_rps": 2,
    "burst": 4,
    "retry_after_ms": 412,
    "upgrade_url": "https://dashboard.crius.sh",
    "docs_url": "https://docs.crius.sh/plans-and-limits/"
  }
}

Handling 429 well

async function crius(path, tries = 4) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(`https://api.crius.sh${path}`, {
      headers: { "x-api-key": process.env.CRIUS_API_KEY },
    });
    if (res.status !== 429) return res.json();
    const body = await res.json();
    if (body.error?.code === "quota_exceeded") throw new Error("monthly credits used up");
    const wait = Number(res.headers.get("retry-after") ?? 1) * 1000;
    await new Promise((r) => setTimeout(r, wait + Math.random() * 250));
  }
  throw new Error("still rate limited");
}

Usage and alerts

The dashboard shows usage per day and per endpoint, and GET /v1/account/usage returns the same data. We email you when you reach 50%, 80%, 90% and 100% of your monthly credits.