Auto Top-up

Automatically replenish your deployment balance when it drops below a threshold.

Overview

Auto top-up monitors your escrow balances and adds funds automatically when they fall below a configured minimum. This prevents deployments from pausing due to depleted escrow.

How It Works

The system checks escrow balances every 60 seconds
If a balance drops below your configured minimum threshold, a top-up is triggered
The configured top-up amount is transferred from your main account to the escrow
You receive an email confirmation of the top-up

Setting	Description	Example
Minimum threshold	Balance level that triggers a top-up	$10.00
Top-up amount	Amount added when threshold is reached	$50.00

Setting Up Auto Top-up

Open Billing Settings

Navigate to Settings → Billing → Auto Top-up in the dashboard.

Enable Auto Top-up

Toggle Enable Auto Top-up to on.

Set Minimum Threshold

Enter the balance level that should trigger a top-up. A good default is 1 hour of estimated runtime cost.

Set Top-up Amount

Enter the amount to add each time the threshold is reached. This should cover several hours of runtime.

Save

Click Save to activate. The system begins monitoring immediately.

Email Alerts

Even without auto top-up enabled, you can receive low balance email alerts:

Low balance warning -- sent when escrow falls below 1 hour of runtime
Critical balance warning -- sent when escrow falls below 10 minutes of runtime
Deployment paused -- sent when escrow is fully depleted

To enable email alerts, add your email address in Settings → Account → Email Notifications.

Best Practice

Combine auto top-up with low balance email alerts for maximum uptime. Auto top-up handles routine replenishment while email alerts keep you informed of spending patterns.

Requirements

Your main account must have sufficient funds to cover the top-up amount
If your main account balance is insufficient, the top-up fails and you receive an email notification
Auto top-up applies to all active deployments on your account

API Configuration

PUT /api/v1/billing/auto-topup

curl -X PUT \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "min_threshold": 10.00,
    "topup_amount": 50.00
  }' \
  https://app.kovanetwork.com/api/v1/billing/auto-topup

Response:

{
  "success": true,
  "auto_topup": {
    "enabled": true,
    "min_threshold": 10.00,
    "topup_amount": 50.00,
    "updated_at": "2026-02-11T12:00:00Z"
  }
}