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

# Plans

> Pay as you go or Growth: prices, included credits, billing and plan changes.

Every plan gets the same API: all endpoints and streams, EVM and Solana, with the same limits. A credit buys the same call on every plan ([credit grid](https://docs.serialized.xyz/authentication.md#credits)): the plan sets its price, and Growth adds credits included each month.

## The plans

| Plan | Monthly fee | Credits included each month | Credits beyond included |
| - | - | - | - |
| **Pay as you go** | None | None (100,000 free credits once, when you add a card) | **\$350 per 1M** (\$0.00035 per credit) |
| **Growth 5M** | **\$1,500** | 5,000,000 | **\$300 per 1M** (\$0.0003 per credit) |
| **Growth 10M** | **\$2,500** | 10,000,000 | **\$250 per 1M** (\$0.00025 per credit) |
| **Growth 20M** | **\$4,000** | 20,000,000 | **\$200 per 1M** (\$0.0002 per credit) |
| **Custom** | By contract | By contract | Volume pricing |

Prices are in USD, before tax. Every new account starts on pay as you go. Custom is for high volume, dedicated limits, custom endpoints or chains: [talk to us](https://docs.serialized.xyz/support.md).

## Pay as you go

No fee and no minimum: you pay for the credits you use. Your card is charged as usage grows during the month, then for the balance on your [reset date](#your-reset-date). Your first 100,000 credits are free once you add a card.

## Growth

* **Your plan starts the day you subscribe.** The fee is charged at that moment, in advance, for a full month.
* **It renews every month on that date, at that time (UTC).** This is your [reset date](#your-reset-date): the fee is charged again and your included credits reset. In a month without that day (the 29th to the 31st), it renews on the last day of the month.
* **Included credits do not roll over.** Credits you do not use in a period are not carried to the next one.
* **Usage continues beyond the included credits.** It is billed like pay as you go, at your plan's rate: charged as it grows, then the balance on your reset date. That invoice carries the balance of the period that just closed and, if you stay on Growth, the fee of the new one.
* **Running out of included credits never stops your calls.** Only your [monthly spend cap](https://docs.serialized.xyz/authentication.md#pricing) can stop them, and on Growth it applies to usage beyond your included credits only (the plan fee is not counted). An unpaid invoice also pauses calls until it is paid ([failed plan payment](#failed-plan-payment)).

### Example

Growth 5M, started on October 15 at 14:32 UTC, with 6,200,000 credits used before November 15 at 14:32 UTC:

| October 15 to November 15 | Amount |
| - | - |
| Fee, charged on October 15 | \$1,500 |
| Included credits | 5,000,000 |
| Beyond included: 1,200,000 credits at \$300 per 1M | \$360 |
| **Total for the period** | **\$1,860** |

The same 6,200,000 credits cost \$2,170 on pay as you go (free credits aside) and \$2,500 on Growth 10M.

### Which tier fits

Your tier does not follow your usage: pick the one that matches your monthly volume.

* **Growth 5M** costs less than pay as you go above 4,285,714 credits a month.
* **Growth 10M** costs less than Growth 5M above 8,333,333 credits a month.
* **Growth 20M** costs less than Growth 10M above 16,000,000 credits a month.

A 20,000,000-credit month costs \$6,000 on Growth 5M and \$4,000 on Growth 20M.

### Your reset date

Every account has a reset date: the moment its included credits reset, its plan fee renews and its billing period closes. [Billing](https://serialized.xyz/portal/billing) and the Usage page of the portal show your next one.

* **Your subscription starts your reset date**: the moment you add your card on pay as you go, or pay your first Growth fee. It comes back every month at that time (UTC).
* **Starting Growth or moving up a tier** sets it to the moment the new plan starts. It then stays the same for as long as your subscription runs, also if you move down a tier or go back to pay as you go.
* **Subscribing again after your subscription ended** sets a new reset date: the moment you pay.
* **A pay as you go subscription started before October 16, 2026** keeps the 1st of each month at 00:00 UTC, until it starts Growth.

## Changing plans

**Starting Growth and moving up a tier happen right away. Moving down a tier and going back to pay as you go take effect on your next reset date.**

* **Start Growth** in [Billing](https://serialized.xyz/portal/billing): choose a tier on the Growth card.
  * No subscription yet, or your subscription ended: you pay the fee at checkout and your plan starts then.
  * On pay as you go: confirm "Start Growth". Your usage until the minute after you confirm is billed at pay as you go; from then, it counts toward your included Growth credits. The fee is charged to your card on file about 5 minutes later, on the same invoice as that pay as you go usage, and your reset date moves to that moment. If the card is declined, nothing changes: your usage stays on pay as you go and you can try again. Until the fee is charged, you can cancel from the same place.
* **Move up a tier** (for example from Growth 5M to Growth 10M): confirm "Upgrade now". The new tier starts about 5 minutes later. You pay its full fee then, minus the value of the included credits you did not use on your current tier: with 3,000,000 of your 5,000,000 credits used, 40% of the \$1,500 fee comes back, so Growth 10M costs \$2,500 minus \$600. Usage beyond your current tier's included credits until then is billed at its rate, on the same invoice. Your new included credits start at once and your reset date moves to that moment. If the card is declined, nothing changes and you can try again.
* **Move down a tier** from the same card: the new tier starts on your next reset date. Your reset date stays the same.
* **Cancel** Growth from Billing at any time: you go back to pay as you go on your next reset date, with the same keys, card and reset date. The current period stays on Growth until then.
* **Undo** a scheduled change from the same place, until it takes effect.
* **Around your reset date**, from 20 minutes before it until 1 hour after it, a change you ask for is queued and applied when that window ends. A queued move down, or back to pay as you go, then takes effect on the reset date after that one. You can cancel a queued change from the same place until it applies.
* Moving down or cancelling never refunds part of a fee: a Growth period always runs to its reset date.
* To move to Growth or to a higher tier, pay any open invoice first. Moving down a tier or cancelling does not need it.

## Failed plan payment

**When your plan renews and its fee cannot be charged, your API keeps working for 15 days** while your card is retried, until 00:00 UTC on the 16th day after the first failure. Your included credits stay available; usage beyond them is limited until the fee is paid. Pay the open invoice ("Pay invoice" in [Billing](https://serialized.xyz/portal/billing)) to keep your plan. If it is still unpaid after the 15 days, billable calls pause until it is paid.

No further plan fee is charged while a fee is unpaid: your plan moves to pay as you go on your next reset date, unless you pay before then.

Any other failed payment, such as an invoice for usage beyond your included credits, pauses billable calls until the invoice is paid.

While calls are paused, they answer `402` with `details.action` set to `add_payment` ([payment responses](https://docs.serialized.xyz/authentication.md#payment-and-quota-responses)).

## Free credits

Free credits lower pay as you go bills only. They count down with all your usage, Growth periods included.

## Limits

Pay as you go and Growth have the same API limits: per-key rate limits, group caps and stream limits ([rate limits](https://docs.serialized.xyz/authentication.md#rate-limits)). Custom plans get dedicated limits.

## Usage and invoices

The [portal](https://serialized.xyz/portal) shows your plan, your next reset date, the included credits left, your usage beyond them and every invoice. Over the API, [`GET /v1/usage`](https://docs.serialized.xyz/endpoints/usage) and the `X-Credits-Remaining` header report what your account can use right now. The `plan` field of `GET /v1/usage` is the name of your current plan, the same as in the portal. Its `month` and `credits.used` cover the calendar month (UTC): when your reset date is not the 1st, the portal shows the totals of your own period.


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