Engineering Guide

Grok Message Limit, the Shared Weekly Usage Pool & xAI Rate Limits

"Grok message limit" means two completely different things, and confusing them wastes hours. One is the consumer app limit — how much you can use Grok inside X, the Grok apps, and SuperGrok, which as of a June 2026 rollout is now a single compute-metered shared weekly usage pool rather than fixed per-product message counts. The other is the xAI API rate limit — exact requests-per-second and tokens-per-minute caps keyed to how much you have spent. This guide answers the five questions people actually arrive with — what the shared pool is and what shares it, what every field on Settings → Usage means, when it resets, what Extra Usage Credits cost, and what happens the moment you hit the limit — then covers the API tiers. Every consumer figure we state as fact is attributed to xAI's own Grok FAQ and dated, every API number to xAI's rate-limits and models docs, and where xAI publishes no number we say so instead of guessing.

Grok message limits and xAI API rate limits — what each tier gives you and how to raise it

The two Grok limits, separated

"Grok message limit" refers to two different systems, and the fix depends entirely on which one you hit. Before anything else, figure out which side you are on:

If you are chatting in an app and got cut off, read the next five sections. If your code got an HTTP 429, jump to API tiers. The two rarely need the same answer, and one detail catches people out: API access inside a consumer subscription draws on the consumer pool, while a developer key on the xAI API is governed by the spend-tier system instead.

What the shared weekly usage pool is, and what shares it

The shared weekly usage pool is one allowance included with your Grok subscription that you can spend across any Grok product — Chat, Imagine, Voice, Build and API — instead of a separate daily message limit per feature. xAI's Grok FAQ describes it as one shared weekly usage pool you can spend however you like across any Grok product, and says you are free to consume the entire pool on a single product or spread it across several.

Three properties follow from that design, and they are the reason "how many messages do I get" has no answer:

The tiers themselves are described only qualitatively, and more thinly than most guides admit. What the FAQ actually says is generic: you can upgrade to a higher plan for a larger weekly allowance, and upgrading gives significantly more weekly usage at a lower cost per action than repeatedly buying credits. It never states which named plan sits where, and it publishes no numeric per-tier allowance. SuperGrok Heavy appears in the FAQ only as a yearly subscription type; that it carries the biggest pool is the obvious commercial reading, not a sentence xAI has written.

Consumer tierWhat xAI says you get (as of July 2026)Shares the weekly pool?Numeric limit published?
FreeFree-tier Chat and Voice limits, separate from any weekly pool, resetting on their own scheduleNo — separate free-tier limitsNo
SuperGrokA weekly usage allowance included with the subscription, spendable across Chat, Imagine, Voice, Build and APIYesNo — the pool is compute-metered
SuperGrok HeavyThe higher paid plan; appears in the FAQ only as a yearly subscription type. The FAQ says a higher plan carries a larger weekly allowance, but never sizes any named plan's poolYesNo — the pool is compute-metered
Extra Usage CreditsPay-as-you-go top-up, minimum $5, bought on the web; used only after the included pool is exhaustedNo — spends after the poolMinimum purchase only ($5)
How this is sourced. Every consumer figure stated as fact on this page comes from xAI's official Grok FAQ, and every API number from xAI's rate-limits and models pages — all three re-verified 2026-07-30. We are not measuring xAI's product mechanics; we are quoting the vendor and dating the quote. The one section that is ours rather than xAI's is the measured benchmark, and it is labelled as such. Three things we could not verify from a primary source and therefore do not state: subscription prices per tier (x.ai's plan page returns HTTP 403 to automated fetching), any numeric per-tier message or credit rate, and which named plan — SuperGrok or SuperGrok Heavy — carries which weekly allowance. Consumer limits change often; check the live Usage tab for your own account.

Settings → Usage: where it is, and what every field means

Open Settings and select Usage — the tab shows four things: a progress bar with your current usage percentage, a percentage breakdown by product, your weekly reset date and time, and your Extra Usage Credits balance if you have one. That tab is the only authoritative statement of your own allowance; nothing published anywhere else tells you how much you have left.

Step by step:

  1. Open Settings in Grok.
  2. Select the Usage tab.
  3. Read the progress bar for the week, then the per-product breakdown underneath it.
  4. Note the reset date and time — it is specific to your account (see below).
  5. If you want to top up, do it here on the web. The FAQ states Extra Usage Credits can currently only be purchased on the web, so if you are in a mobile app and cannot find a buy button, that is expected rather than a bug.

What each field actually tells you:

When the weekly limit resets, and on what clock

The pool resets once a week on a schedule specific to your account, shown as a date and time in Settings → Usage — xAI does not publish a fixed reset day, hour or timezone. The FAQ's wording is that the usage pool limit resets every week on a schedule shown in the Usage tab in Settings. That is the whole of what the vendor states.

So four practical consequences, and one honest gap:

What Extra Usage Credits are, what they cost, and how they stack with the pool

Extra Usage Credits are pay-as-you-go funds you buy on the web from Settings → Usage, with a minimum purchase of $5, and they are consumed only after your included weekly pool is exhausted. They are a top-up, not an upgrade: they extend the current week rather than raise the weekly allowance.

What xAI's FAQ states about them, verified 2026-07-30:

What is not published: the per-action or per-token price of a credit. xAI states that credits bill at standard rates and that this is worse than the included effective rate, but it does not publish a consumer rate card mapping credits to chat turns, images or video seconds. So $5 buys $5 of standard-rate compute, and how far that goes depends entirely on which product you spend it in. Anyone quoting you "$5 = N messages" is inventing the N.

That last point has a real consequence. Because credits are deliberately priced above your subscription's effective rate, repeatedly topping up is the most expensive way to buy Grok compute. If the work is programmatic rather than conversational, the developer API prices per token on a published rate card instead — the current Grok token rates are in our Grok API pricing guide.

What happens the moment you hit the limit

Paid features pause until your weekly limit resets — your account is not suspended, your history is not deleted, and you keep Grok's free-tier Chat and Voice limits, which are separate and reset on their own schedule. The FAQ's wording is that when your weekly usage limit is met, paid features will pause until your weekly limit resets, and that you still have access to Grok's free tier limits on Chat and Voice.

So the practical experience is a downgrade, not a lockout. From there you have four documented moves:

  1. Wait for the reset shown in Settings → Usage. Free.
  2. Buy Extra Usage Credits — $5 minimum, web only, spent immediately since the pool is already empty.
  3. Enable Auto Top Up so the next exhaustion is invisible. You set the amount and the monthly cap.
  4. Upgrade to a higher plan for a larger weekly allowance. The FAQ lists this as one of your options and adds that upgrading gives significantly more weekly usage at a lower cost per action than repeatedly topping up — but it does not say what any named plan's pool is.

One thing that is not what happens: an HTTP 429. That error belongs to the developer API, where the mechanism is a per-second or per-minute cap rather than a weekly pool. If you got a 429 from code, you did not exhaust a weekly pool — see handling a Grok 429. Every status code the xAI endpoint can return is decoded in our LLM API error-code reference.

About those "1,000 messages a day" numbers

You will find specific consumer counts on third-party blogs — SuperGrok ~1,000 text messages/day, SuperGrok Heavy ~10,000/day, free tier ~10 messages per 2 hours. These are not confirmed by xAI and appear superseded. They circulate widely, but xAI's official pages do not state them, and the June 2026 weekly-pool system replaced the fixed per-product model they came from. Treat them as unofficial and likely stale estimates — useful as rough intuition, wrong as a spec. If a number about consumer Grok limits does not appear on an xAI page, do not build a decision on it. The only authoritative source for your own current allowance is the in-app Usage percentage.

This is also why this page keeps saying "xAI does not publish that." A compute-metered pool cannot be expressed as a message count without knowing which products you use, so a message count is not a number xAI is withholding — it is a number that does not exist under the current system.

xAI API rate limits: keyed to your spend

On the xAI API, your rate-limit tier is set by cumulative API spend since January 1, 2026 — and tiers unlock automatically and never downgrade. This is the layer you design against when you build on Grok in code. The thresholds, from xAI's rate-limits page (verified 2026-07-30):

TierCumulative API spend (since Jan 1, 2026)How you reach it
Tier 0$0 (default)Every new account starts here
Tier 1$50Unlocks automatically
Tier 2$250Unlocks automatically
Tier 3$1,000Unlocks automatically
Tier 4$5,000Unlocks automatically
EnterpriseOn requestContact xAI

Because tiers are spend-cumulative and one-way, you do not lose headroom in a slow month — once you cross a threshold you stay there. Exceed a limit and the API returns HTTP 429; the fix is below.

API RPS and TPM caps per model

Each model has its own RPS (requests per second) and TPM (tokens per minute) cap, and both rise with your tier — but grok-4.5 sits on a far larger allocation than every other text model. The published caps across Tiers 0–4, from xAI's rate-limits page (verified 2026-07-30):

Model classMetricTier 0Tier 1Tier 2Tier 3Tier 4
grok-4.5RPS150172208312500
grok-4.5TPM50M53M60M74M100M
Standard text (grok-4.3, grok-4.20-0309, grok-build-0.1)RPS375075125208
Standard text (grok-4.3, grok-4.20-0309, grok-build-0.1)TPM10M15M25M45M85M
Multi-agent (grok-4.20-multi-agent-0309)RPS912183156
Multi-agent (grok-4.20-multi-agent-0309)TPM2.5M3.7M6.2M11M21M
Image models (grok-imagine-image, -image-quality)RPS5 RPS (all tiers)
Video models (grok-imagine-video, -video-1.5)RPS10 RPS (all tiers)

Three things to design around:

Model IDs and pricing you will pair with these limits (xAI's models page, July 2026): grok-4.3 and the grok-4.20 variants ship a 1M-token context at $1.25 / 1M input and $2.50 / 1M output; grok-4.5 is a 500k context at $2 / $6; the code model grok-build-0.1 (256k context) is $1.00 / $2.00. All three text rates double above a 200k-token context — $2.50/$5.00, $4/$12 and $2.00/$4.00 respectively — so long-context work is not priced at the headline number. Image and video price separately (grok-imagine-image $0.02/image, grok-imagine-video $0.050/sec).

How to get more Grok usage (the four levers)

Whether you are capped in the app or in code, there are exactly four ways to raise the ceiling. Pick by which limit you hit:

  1. Upgrade your consumer plan. The FAQ states that a higher plan carries a larger weekly allowance at a lower cost per action; it does not publish what any individual plan's pool is. Best when your cap is the in-app weekly pool.
  2. Buy Extra Usage Credits. From the web Usage tab, $5 minimum, when you just need to finish the week — with the caveat that they bill at standard rates, which is worse than your subscription's effective rate.
  3. Move to the xAI API. Limits become explicit RPS/TPM instead of an opaque pool, and they rise automatically as your cumulative spend crosses each tier — no plan negotiation. This is the right move if you are building a product, not chatting. Start with a Grok API key.
  4. Route through a gateway that fails over. When Grok returns a 429, a gateway can reroute the request to an equivalent model so your users never see the error — covered below.
Hit a Grok limit In an app (weekly pool) In code (HTTP 429) Upgrade / buy Usage Credits Raise tier by spend, or fail over Or move app work to the API
Which Grok limit did you hit, and the lever for each. Source: xAI Grok FAQ & rate-limits docs, verified 2026-07-30.

Handling a Grok API 429

Exceeding your tier's RPS or TPM cap returns HTTP 429 — treat it as transient, back off, and spread load. The standard, correct retry loop against the OpenAI-compatible xAI endpoint:

import time, random, httpx

def call_grok(payload, key, tries=6):
    url = "https://api.x.ai/v1/chat/completions"
    headers = {"Authorization": f"Bearer {key}"}
    for i in range(tries):
        r = httpx.post(url, json=payload, headers=headers)
        if r.status_code == 429:                # RPS/TPM cap for this tier
            wait = float(r.headers.get("retry-after", 2 ** i))
            time.sleep(wait + random.random())      # backoff + jitter
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError("exhausted retries")

Beyond the retry, the structural fixes map to the tiers above: move throughput-critical work onto grok-4.5, whose caps start far above the other text models, let cumulative spend advance you automatically to a higher tier, keep multi-agent calls under their tighter separate cap, queue image and video work behind their flat per-tier RPS, or fail over. The generic version of all of this is in our rate-limit fix guide. Because xAI's API is OpenAI-compatible, the same retry code works if you later swap models.

Pay for more Grok, or route elsewhere: what we measured

If the work behind your limit is code generation, buying more Grok is not automatically the cheapest fix — on our own executed benchmark, several models finished the same nine tasks at a fraction of Grok's measured cost with the same 9/9 score. This is the one part of this page that is ours rather than xAI's: we ran it, and the numbers below are measured, not quoted.

We put 23 models through one harness of nine executed Python tasks. The original sweep was 13 models run in one sitting; the other 10 ran later on the same harness with the same settings. 20 of the 23 scored 9/9. Grok 4.5 is one of them; Grok 4.3 is not — it missed flatten.

ModelScoreMeasured cost / 1k tasksMean latencyReasoning tokensPriced at
Qwen3 Coder Next9/9$0.107.0 s02026-07-17
DeepSeek V4 Flash9/9$0.1314.5 s5682026-07-17
Mistral Medium 3.59/9$0.872.9 s02026-07-17
Claude Haiku 4.59/9$0.943.7 s02026-07-29
Grok 4.38/9$1.758.4 s4822026-07-17
Grok 4.59/9$2.936.6 s2892026-07-29
Measured cost per 1,000 tasks: Grok against cheaper models that also scored 9/9Nine executed Python tasks, temperature 0, one scored attempt each. Priced on the dates in the table above.Qwen3 Coder Next$0.10 · 9/9DeepSeek V4 Flash$0.13 · 9/9Mistral Medium 3.5$0.87 · 9/9Claude Haiku 4.5$0.94 · 9/9Grok 4.3$1.75 · 8/9Grok 4.5$2.93 · 9/9One scale throughout: 200 px per dollar. Cost is measured token counts multiplied by list price on the stated date, not a vendor invoice.
Chart: DataLLM Lab. Scores, latencies and reasoning-token counts are measured on our executed nine-task Python benchmark; cost is those token counts multiplied by each model's list price on the date shown. Method: our methodology. Full run: the coding cost benchmark.

The spread between the cheapest 9/9 in that table and Grok 4.5 is 29x — $0.10 against $2.93 per 1,000 tasks — on nine tasks that neither model found hard. Grok 4.5's own detail is in our Grok 4.5 review, Grok 4.3's miss in the Grok 4.3 review, and the whole field ranked four different ways in the AI coding ranking.

How those numbers were produced, and what they do not cover. Nine executed Python tasks — two_sum, valid_parentheses, merge_intervals, roman_to_int, lcs_len, flatten, top_k_words, token_bucket, parse_csv_line. The model gets a signature and a prose spec and never sees the assertions; the returned code runs in an isolated python3 -I subprocess with a 12-second timeout; temperature 0, max_tokens 4000, one scored attempt per task, retried only on an API error. Calls go through OpenRouter's OpenAI-compatible endpoint, deliberately not through the DataLLM Lab gateway. Cost is measured token counts multiplied by list price on the stated date — a measured cost, not a billed invoice; 49 of roughly 396 catalogue models repriced in the twelve days to 2026-07-29, so an undated cost figure is not a fact.

The harness does not measure long-context reasoning, multi-file refactoring, agentic or multi-turn tool use, non-Python work, or vision, and the 4,000-token ceiling can truncate a verbose model. Two boundaries matter especially here: this table is about API models, so it does not help a consumer chatting in the Grok app — you cannot route a SuperGrok conversation elsewhere — and it says nothing about the features people actually pay a Grok subscription for, like Imagine or Voice. It is evidence for one decision only: if the workload behind your quota is bounded code generation, the cheap route exists and we measured it.

When a gateway removes the ceiling

A single provider's rate limit does not have to be your application's rate limit. A Grok 429 — your tier's RPS or TPM cap, or a momentary burst — is exactly the kind of transient error a gateway can absorb: on a 429 it retries the request on an equivalent model from another provider, so the end user never sees the error. You still design within Grok's limits for Grok-specific work, but the not-your-fault ceiling becomes an invisible reroute instead of a failed request. See routing & failover for how that is wired. If you are choosing between Grok and other options, our Grok vs Groq comparison clears up the name confusion, how to use Grok covers the app side, and best LLM for AI agents covers where the multi-agent model fits.

Turn Grok 429s into invisible reroutes

DataLLM Lab routes across 300+ models on one OpenAI-compatible key — a Grok rate limit fails over to an equivalent model automatically, so your app's ceiling is not one provider's tier. Base URL: https://www.datallmlab.com/v1.

FAQ

What is the Grok shared weekly usage pool, and what shares it?

It is one allowance included with your Grok subscription that you spend across any Grok product rather than a separate daily limit per feature. xAI's Grok FAQ names the five surfaces that share it — API, Build, Chat, Imagine and Voice — and says you may spend the whole pool on one product or across several. It is metered by compute, not messages: a chat message uses little compute, a high-quality video or a long coding task far more. Verified against the FAQ on 2026-07-30.

When does the Grok weekly usage limit reset?

Once a week, on a schedule specific to your account, shown as a date and time in Settings → Usage. xAI does not publish a fixed reset day, hour or timezone, and does not document what the weekly anchor is tied to — so the Usage tab is the only authoritative answer and any stated global reset hour is unsourced. Free-tier Chat and Voice limits are separate and reset on their own schedule.

What does the Settings → Usage tab show?

Four fields, per xAI's FAQ: a progress bar with your current usage percentage, a percentage breakdown by product (API, Build, Chat, Imagine, Voice), your weekly reset date and time, and your Extra Usage Credits balance if you have one. The breakdown is the field to check first when the pool drains faster than expected. Credits can currently only be purchased on the web.

What are Extra Usage Credits and what do they cost?

Pay-as-you-go top-up funds bought from the Usage tab on the web, minimum $5, used only after your included weekly pool is exhausted, and expiring one year after purchase unless otherwise stated. The FAQ says they are priced at standard rates, so the cost per action is higher than the effective rate your subscription gives you. xAI does not publish a per-action or per-token credit rate, so nobody can honestly tell you how many messages $5 buys. Auto Top Up can add credits automatically at an amount and monthly cap you choose.

What happens when I reach the Grok weekly limit?

Paid features pause until the weekly reset. You are not locked out: Grok's free-tier Chat and Voice limits are separate and stay available, resetting on their own schedule. From there you can wait for the reset, buy Extra Usage Credits ($5 minimum, web), enable Auto Top Up, or upgrade to a plan with a larger weekly allowance. An HTTP 429 is a different thing entirely — that is the developer API's per-second or per-minute cap, not the weekly pool.

How many messages does SuperGrok give per day?

xAI publishes no number, and under the current system there is not one to publish: a compute-metered weekly pool has no fixed message count. Third-party figures like ~1,000 text messages/day for SuperGrok or ~10,000/day for Heavy predate the June 2026 weekly-pool rollout and are not confirmed by xAI. The only real answer for your account is the percentage in Settings → Usage.

Written by

Founder of DataLLM Lab, the unified LLM gateway. Kevin tests models the boring way — same prompts, real costs, unedited outputs — and writes up what the runs actually show. Articles are drafted with AI assistance and published under his name; every first-party number comes from an executed run.

One API for every model

One API, every model.

Get a single API key for Claude Opus 4.7, GPT-5.4, and 300+ more — with automatic price comparison and routing to the best model for every request.