Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chainbase.com/llms.txt

Use this file to discover all available pages before exploring further.

Chainbase meters paid API usage with credits. Every successful request to a metered API consumes a fixed number of credits, and your monthly plan grants a credit allowance that resets on a regular cycle.

​
Which APIs consume credits

ProductHow it’s metered
Web3 APIPer request, varying by method. See Credit Cost.
SQL APIFlat 100 credits per query execution.
Other Chainbase products are billed separately and are not covered by this credit system.

​
Plans & monthly allowance

PlanMonthly creditsBilling cycle
Free200,000Calendar month — resets on the 1st of each month (UTC).
Developer10,000,000Anchored to your subscription day — resets on the same day-of-month each cycle. If your anchor day exceeds the days in a given month (e.g. day 31 in February), the cycle ends on that month’s last day.
EnterpriseCustomCustom billing cycle, agreed in your contract. Contact sales for details.
Unused credits do not roll over to the next cycle. Credit usage is tracked at the account level. All API keys, apps, and projects under the same account share a single monthly allowance — there is no per-key quota.

​
Cost example

A workload running 5,000 native balance lookups, 1,000 NFT metadata calls, and 100 SQL queries per day:
Calls / dayMethodUnit costDaily credits
5,000Get Native Token Balance15,000
1,000Get NFT Metadata11,000
100SQL Query Execution10010,000
Total16,000 / day ≈ 480,000 / month
That workload exceeds the Free plan (200,000 credits/month) and fits comfortably within the Developer plan (10,000,000 credits/month).

​
Extra Credits Usage

When your monthly plan allowance is fully consumed, requests can continue to be served by extra credits purchased on top of your plan. Extra credits give you a one-off, non-expiring buffer for traffic spikes without forcing a plan upgrade.

​
How they’re priced

The base rate is $1 = 100,000 credits, with volume bonuses applied automatically at checkout:
Single purchase amountBonusEffective credits
1–1 – 49—100,000 / $
50–50 – 249+5%105,000 / $
250–250 – 999+10%110,000 / $
1,000–1,000 – 10,000+20%120,000 / $
Each purchase must be between 1and1 and 10,000 USD. The discount is determined by each individual purchase amount, not by your cumulative spend.

​
How they’re consumed

  1. Every billable request is charged to your plan allowance first.
  2. Once the plan allowance for the current cycle is exhausted, additional requests draw from your extra credit balance — provided extra credit consumption is enabled for your account.
  3. If extra credit consumption is disabled, requests are rejected after the plan allowance is used up, even if you have unused extra credits. This lets you hard-cap your monthly spend.
  4. Extra credits do not expire and are not reset when the plan cycle resets. Multiple purchases stack into a single balance.
  5. Unused plan allowance never converts into extra credits.
You can enable or disable extra credit consumption at any time in the console, and you can buy additional packs whenever needed. Enterprise plans do not use the extra credit mechanism — usage limits and overage handling are governed by the contract.

​
Monitoring usage

Track your live credit consumption, current cycle window, and remaining balance in the console: console.chainbase.com/settings/billing?tab=credit The dashboard breaks usage down by product (Web3 API, SQL API) and by day, so you can identify which methods drive your spend.

​
How a request is charged

  1. The gateway authenticates the request and looks up the method’s credit cost.
  2. Web3 API — credits are recorded only on a successful response. Failed requests (4xx/5xx returned by Chainbase) are not charged.
  3. SQL API — credits are deducted immediately on submission, as soon as the query is accepted for execution. The 100-credit cost is charged regardless of whether the query ultimately succeeds, fails at runtime, or is cancelled, because the underlying compute resources are committed at submission time.
  4. When your plan allowance is exhausted, requests fall back to extra credits (if enabled). Without extra credits — or once the extra credit balance is also depleted — further requests are rejected with HTTP 429 Too Many Requests until the cycle resets or additional extra credits are purchased.
For the per-method credit table, see Credit Cost.

​
Rate limits

The monthly credit allowance governs total volume. Independently, Web3 API traffic is also subject to a per-second rate limit measured in credits per second. During the current rollout period, both controls may apply to your Web3 API traffic and are evaluated independently — exceeding either one will result in an HTTP 429 response.
PlanWeb3 API per-second rate limit
Free3 credits / second
Developer30 credits / second
EnterpriseCustom
Because the limit is measured in credits rather than raw requests, the effective request rate depends on each method’s cost. For example, on the Free plan you can sustain 3 calls/second to a 1-credit method (e.g. Get Native Token Balance) but only 1 call/second to a 3-credit method (e.g. Get ERC20 Token Balances). The per-second limit does not apply to SQL API — SQL queries are governed only by the monthly credit allowance and any concurrency limits described in the SQL API documentation.

​
FAQ

Yes. Credit consumption is tracked at the account level. All keys, apps, and projects under your account draw from the same monthly allowance — there is no per-key budget.
Web3 API charges only on a successful response. Network timeouts and 4xx/5xx responses returned by Chainbase are not charged. If your client retries the request, each retry that reaches Chainbase and succeeds is billed independently.SQL API charges at submission. Once a query has been accepted by the gateway, the 100 credits are final — including for client-side timeouts that result in a retry, since each accepted submission is billed.
No. Each Web3 API call is one request and consumes the listed credits for that method, regardless of how many records the response contains.
Yes. Each page request is a separate billable call.
Both limit types return HTTP 429 Too Many Requests:
  • Monthly credits exhausted — your plan allowance (and any extra credits, if enabled) is depleted for the current cycle.
  • Per-second credit limit exceeded (Web3 API only) — momentary Web3 API burst exceeds your plan’s per-second credit limit (3 on Free, 30 on Developer).
Check the response body and the billing dashboard to determine which one was triggered. A short retry with backoff usually clears per-second throttling; a monthly-quota 429 will persist until the cycle resets or extra credits are added.
Your current cycle window and the new plan’s allowance take effect according to the rules in the Plans & monthly allowance section. The console always shows your live cycle window and remaining balance — refer to it after any plan change.
Yes. Toggle off extra credit consumption in the console. With it off, requests are rejected with HTTP 429 once your plan allowance is used up, even if you have unused extra credits.