Skip to main content
GET
/
v1
/
usage
curl -X GET "https://api.blockdb.io/v1/usage" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY"

{
  "plan": "growth",
  "cu_used": 0,
  "cu_limit": 4100000,
  "cu_remaining": 4100000,
  "cu_reset_at": "2026-05-22T11:53:12.000Z",
  "rate_limit_rps": 1000
}

Documentation Index

Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt

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

​
Overview

Retrieves your current subscription plan, compute unit (CU) usage for the billing period, remaining allowance, when the CU counter resets, and your account’s configured requests-per-second ceiling. CU and RPS limits are shared across every API key on the account—see Rate limiting. Use this endpoint to stay within quota and to align client throttling with your plan.
This endpoint is free to query and does not consume compute units.

​
Parameters

This endpoint does not require a request body. You may authenticate with any active key; the response describes your account, not a per-key slice of usage or RPS.

​
Response Fields

​
plan
string
Your subscription plan identifier (for example growth).
​
cu_used
number
Compute units consumed in the current billing period.
​
cu_limit
number
Total compute units included in your plan for the current billing period.
​
cu_remaining
number
Compute units left before you hit cu_limit (cu_limit minus cu_used).
​
cu_reset_at
string
When the CU counter resets for the next billing period (ISO-8601 UTC).
​
rate_limit_rps
number
Configured maximum requests per second for your account. All keys share this same RPS budget; it is not split per key.

​
Best Practices

Query this endpoint periodically (for example daily) to monitor consumption and avoid unexpected throttling near the end of a billing period.
Compare cu_remaining with expected workload so you can upgrade or reduce query volume before hitting cu_limit.
While this endpoint does not consume CUs, automated polling should still use a reasonable interval so you do not hit management-endpoint rate limits.

​
See Also

curl -X GET "https://api.blockdb.io/v1/usage" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY"

{
  "plan": "growth",
  "cu_used": 0,
  "cu_limit": 4100000,
  "cu_remaining": 4100000,
  "cu_reset_at": "2026-05-22T11:53:12.000Z",
  "rate_limit_rps": 1000
}
Last modified on April 22, 2026