Usage & metering

ZenVault meters billable usage per workspace, aggregated by metric and month. This is the basis for plans and invoicing.

Metered units

Metric	Counts
api_request	Each authenticated public /v1 API call (your API-key traffic)
transfer_created	Each transfer created (external / internal / contract-call / approve), including held ones
active_vaults	A live gauge — non-gas vaults currently in the workspace

Counts are aggregated into monthly periods (YYYY-MM, UTC).

Where to see it

Usage is visible in the console for your workspace (current-period counters plus the active-vault gauge). The shape returned:

{
  "workspaceId": "…",
  "period": "2026-07",
  "counters": { "api_request": 10432, "transfer_created": 217 },
  "activeVaults": 12
}

Notes

• api_request counts your public API traffic only — console (human) and admin traffic aren't billable and aren't counted.
• Held transfers count as transfer_created once, at creation; releasing a held transfer later does not double-count.
• Rate limits are separate from metering — see Workspaces & keys.

:::note Billing Turning metered usage into plans/invoices is on the roadmap. Reach out to the ZenVault team to discuss pricing for your volume. :::