Skip to content

Usage and limits

Understand Subgraphs query metering, Managed Subgraphs, rate limits, and production safeguards.

Budget your Subgraphs spending and size your workloads to your plan. Queries and Managed Subgraph indexing have separate rates. Each query uses a query rate, and a Managed Subgraph also accrues indexing charges while GraphOps keeps it indexed, not only when you send queries.

Billing model

ModeBilling behaviorUse it when
StandardEach GraphQL request uses the standard query rate shown below.Your deployment is not registered as a Managed Subgraph.
Managed SubgraphIndexing charges accrue hourly based on attached time, entity count, and storage. Queries use the Managed Subgraph rate shown below.You want GraphOps to keep your deployment indexed and manage version upgrades.

Current credit rates

The rates below show the current query and indexing charges. Managed Subgraph estimates in the platform use current indexing measurements and these rates; an estimate is not a bill.

Current rates. Last updated: Oct 23, 2026, 12:00 AM UTC.

Usage componentApplies toRate
QueriesDefault1 credit per query
QueriesBilling mode: managed0 credits per query
Managed allocated timeDefault2,500 credits per hour
Managed entity timeDefault2,500 credits per 1 million entity-hours
Managed storage timeDefault100 credits per GiB-hour

During an upgrade, Current and Next can both accrue indexing usage while they are prepared. A previous version may continue accruing briefly while its service is removed after promotion.

Plan limits

Limits are shared across your organization and depend on your plan. Check your plan terms or contact support for the values that apply to your workload.

The primary operational limit is query rate. Other limits can apply by organization and plan.

LimitApplies toGuidance
Query rateGraphQL requests for the organizationBound worker concurrency and back off after 429.
Query timeoutLong-running or expensive GraphQL queriesReduce selection sets, filters, or page size.
Response sizeLarge entity pages and nested selectionsPage results and request only required fields.
Query complexityDeeply nested or expensive queriesPrefer multiple bounded queries over one unbounded query.
Introspection frequencySchema discovery and code generationRun introspection in development or CI, not per request.

Retry guidance

Retry transient 429, 502, 503, and 504 responses with exponential backoff and jitter. For large entity scans, persist pagination state and retry from the last completed cursor.

Do not retry a query indefinitely if it returns GraphQL validation errors. Validation errors usually mean the query does not match the Subgraph schema.

Production checklist

  • Store API keys outside source code. See Authentication.
  • Use Endpoint Aliases targeting Managed Subgraphs for production endpoints that should follow their upgrades.
  • Include _meta in health checks and important reads.
  • Bound page sizes and use cursor-like pagination for long scans.
  • Use the Managed Subgraph status timestamp when diagnosing unexpected usage.
  • Contact GraphOps support when limits need to be raised.

Next steps