CLI · Account

buyproxy balance

Bandwidth left on every product, with usage bars.

Usage

shell

$ buyproxy balance

Aliases: buyproxy bal, buyproxy usage

balance shows how much bandwidth you have on each product at a glance — the quickest answer to "can I run this job?".

How it works

For each product you hold, the bar shows remaining GB against what the plan started with:

Green — more than 40% left.
Amber — 40% to 15%.
Red — under 15%: time to top up.
+X GB arriving — a payment has gone through and the GB is being added; it becomes live within seconds.
not funded — you've never bought that product.

If any plan expires, the soonest expiry is shown underneath.

Examples

Check balances

shell

$ buyproxy balance

example output

Bandwidth
  Core Residential     ████████████████████░░░░  8.50 GB / 10.0 GB
  Premium Residential  ███░░░░░░░░░░░░░░░░░░░░░  1.20 GB / 10.0 GB  +5.00 GB arriving
  ISP Rotating         ░░░░░░░░░░░░░░░░░░░░░░░░  not funded

  Next expiry: Premium Residential on 11/12/2026

  Need more? buyproxy topup

Find products running low, in a script

shell

$ buyproxy balance --json | jq '.balances[] | select(.activeGb < 1) | .productKey'

JSON output

json

{
  "balances": [
    { "productKey": "residential", "productId": "residential-lite", "planId": "plan_9f2a", "activeGb": 8.5, "pendingGb": 0, "totalGb": 8.5, "expiresAt": null }
  ],
  "plans": [ { "id": "plan_9f2a", "productKey": "residential", "dataGbRemaining": 8.5, "dataGbTotal": 10, "...": "..." } ]
}