Skip to content

Usage and limits

Understand Substreams credit metering, organization-wide limits, and production controls.

Budget Substreams work before a large backfill or a new live consumer. Streams draw credits from your organization's balance at the rates below, and limits on concurrent work are shared across your organization.

Current credit rates

Estimate stream costs from these billable components, then track actual consumption in Platform Usage. For GraphOps-hosted sinks, contact support about enterprise pricing.

Current rates as of Nov 14, 2026, 12:03 AM UTC.

Usage componentApplies toRate
Processed blocksDefault4,000 credits per 1,000 processed blocks
Egress bytesDefault375,000 credits per GiB

Organization limits

These limits apply to your whole organization, not to each API key, and they do not change with your plan size. Contact support for the values that apply to your workload or to request an increase.

LimitApplies toGuidance
Concurrent streamsActive gRPC streams for the organizationBound consumer processes and reconnect loops.
Worker concurrencyParallel package execution workTune backfills to stay within your organization's capacity.
Output throughputBytes sent to consumersReduce selection/output volume or split ranges.
Message sizeLarge block-scoped outputsUse narrower modules or package outputs when possible.
Backfill pressureLarge historical rangesChunk ranges and checkpoint progress.

Control your usage

  • Bound concurrency. Cap consumer processes and reconnect loops so a restart does not open extra streams.
  • Retry with backoff. Retry transient failures with exponential backoff and jitter, then resume from the latest committed cursor. If a stream fails repeatedly at the same block, check the package output, module parameters, and message size.
  • Narrow the output. Choose an output module that emits only the data you store; output volume counts toward throughput limits.
  • Split large backfills. Run bounded ranges you can retry independently, and save progress after each one.
  • Monitor the work. Track blocks processed, bytes out, bytes read, bytes written, stream lag, retries, and errors.

Contact GraphOps support(opens in a new tab) when a limit needs to be raised. See Platform: Usage and limits for billing-window timing and how to confirm your limit values.

Next steps

Last updated