Billing & Usage

Usage tracking, compute units, subscription tiers, rate limits, and billing integration with Hanzo Commerce.

Bootnode billing is based on compute units (CU). Every API call consumes CUs based on the operation complexity. Usage is tracked per-project and synced with Hanzo Commerce for billing.

Subscription Tiers

Tier	Price	CU/day	Rate Limit	Support
Free	$0/mo	10,000	100 req/min	Community
Developer	$49/mo	500,000	1,000 req/min	Email
Growth	$199/mo	5,000,000	10,000 req/min	Priority
Enterprise	Custom	Unlimited	Custom	Dedicated

Usage Tracking

GET /v1/billing/usage

{
  "period": "2025-03",
  "compute_units_used": 234567,
  "compute_units_limit": 500000,
  "requests_total": 89012,
  "top_endpoints": [
    {"endpoint": "rpc_call", "calls": 45000, "cu": 112500},
    {"endpoint": "get_token_balances", "calls": 20000, "cu": 60000}
  ],
  "daily_usage": [
    {"date": "2025-03-01", "cu": 15234, "requests": 6012}
  ]
}

Usage Summary

GET /v1/billing/usage/summary?year=2025&month=3

Returns aggregated usage per endpoint with daily breakdown.

Compute Unit Costs

Operation	CU Cost
`eth_blockNumber`	1
`eth_getBalance`	2
`eth_call`	5
Token balance query	3
NFT metadata query	5
Webhook delivery	1
Smart wallet create	10
Gas estimation	3
Fleet status check	2
Log search	5

Rate Limits

Rate limits are enforced per API key. Headers in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1709312460

GET /v1/billing/limits

Check current rate limit status and remaining quota.

Subscription Management

# Get current subscription
sub = await client.billing.subscription()

# Upgrade tier
await client.billing.upgrade(tier="growth")

# View invoices
invoices = await client.billing.invoices(limit=10)

Hanzo Commerce Integration

Billing is powered by Hanzo Commerce. Payment methods, invoices, and subscriptions are managed through the unified Hanzo billing system:

GET /v1/billing/account
GET /v1/billing/account/subscriptions
GET /v1/billing/account/invoices
GET /v1/billing/account/payment-methods