Skip to Content
Referenceoo CLI

oo billing

The balance, alert, trial top-up, charges, usage by source, estimate and server budget.

Read the Sunport's balance with OpenOrange and what OpenOrange charged, set the low-balance alert, ask for a free trial's next free top-up, read the usage by source and the spend estimate, and read or change the monthly server budget, as Billing does. Reading needs billing.read and changing billing.write; setting the low-balance alert and asking for a top-up are also an administrator's, as on Billing (admin_required). Money is in US dollars, or in JU (100 per US dollar) where OpenOrange counts it so.

oo billing balance

Print the Sunport's prepaid balance as JSON, as Billing shows it. balance has the balance in JU (balanceJu, heldJu), its state (ok, low or empty), whether OpenOrange-paid models stop when it runs out (enforced) and are stopped now (paused), this month's OpenOrange usage (usage: calls and JU by UTC day, by model and by service meter), a free trial's credit and next top-up (trial) and the latest top-ups (credits). balance is null when OpenOrange doesn't bill this Sunport. Next to it: the low-balance alert (alert), a top-up request still on its way (pendingTopUp) and the health of the charge records (chargeMirror). On a paid Sunport, computeAllowance is this UTC month's use against the allowance included per Sunport (busy vCPU-hours, egress GB, AWS surplus vCPU-hours), and machines is each machine's share: an agent or service VM by name, a removed VM (name null), and the Sunport's own server, whose traffic isn't counted in egress (countsEgress false). Going over never slows, blocks or charges anything; overAllowance only says whether allowance emails go out (allowance-notifications).

oo billing balance

It also takes the connection options.

oo billing allowance-notifications

Show or change notification-only compute allowance emails

oo billing allowance-notifications [options]
ArgumentRequiredDefaultChoicesDescription
--set SETnooff, notifyemail at 80% and 100%, or turn emails off; never blocks traffic or charges overages

It also takes the connection options.

oo billing alert

Without options, print the low-balance alert: the balance below which the dashboard warns its administrators (belowJu, in JU), who set it and when. belowJu null is OpenOrange's own warning, below 20% of the last top-up. --below sets it in US dollars; --default goes back to OpenOrange's warning.

oo billing alert [options]
ArgumentRequiredDefaultChoicesDescription
--below USDnowarn below this balance, in US dollars, such as 25 or 12.50
--defaultnogo back to OpenOrange's own warning

It also takes the connection options.

oo billing top-up

Ask OpenOrange for a free trial's next free top-up, as Top up for free on Billing does. A trial gets one while it has one left (trial.topUpsLeft in oo billing balance, null without a limit; none once the limit is used, or while trial.topUpEnabled is false), once its balance is used up and its cooldown has passed (trial.nextTopUpAt); otherwise the answer is top_up_not_available. The request goes to OpenOrange with the Sunport's next heartbeat: oo billing balance shows it as pendingTopUp, then OpenOrange's answer as trial.topUp, granted or refused with its reason: too_soon, balance_left, not_enrolled, or used_up when the free top-up is already used, for example taken in the OpenOrange app first. With none left, buy credit in the OpenOrange app to keep going. Asking again before then answers the same request.

oo billing top-up

It also takes the connection options.

oo billing charges

Print what OpenOrange charged for this Sunport's calls as JSON, as Billing › Charge records shows it: each charge with the request it matches (records; nextCursor reads the next page), or with --summary the period's totals, by line, by model and by day. The period is this month unless --query gives range (today, current_week or current_month), or from and to (its first and last day), and timeZone; filter=unmatched or filter=unpriced, limit and cursor choose the records. Charges name the key and the person behind each request. A Sunport OpenOrange doesn't bill answers not_billed_on_platform. oo export charges saves the same records as CSV; oo api route GET /api/v1/billing/platform-charges lists every input.

oo billing charges [options]
ArgumentRequiredDefaultChoicesDescription
--summarynothe period's totals by line, model and day instead
--query NAME=VALUEnoa period or filter input; repeatable

It also takes the connection options.

oo billing usage

Print Billing's usage by source as JSON: the requests made with keys that are neither an agent's nor a registered API key, under the Sunport service whose keys they are (source: code, clem, chat_titles, apps_builder, local_openclaw, proxy_admin or other), each key with its alias (null for requests without a key), its Code project or session, its requests and when it was last used (lastSeen). Where OpenOrange bills this Sunport (billedOnPlatform), each source and key has what OpenOrange charged (charged; null when the charges can't be read), and sunportServices is the charge records' Sunport services line; elsewhere each has LiteLLM's spend estimate in US dollars (spend). The period is this month in UTC unless --query gives range (today, current_week or current_month), or from and to (its first and last day), and timeZone. Billing shows this month in UTC where OpenOrange bills.

oo billing usage [options]
ArgumentRequiredDefaultChoicesDescription
--query NAME=VALUEnoa period input; repeatable

It also takes the connection options.

oo billing estimate

Print the spend estimate Billing and Overview show where OpenOrange doesn't bill this Sunport, as JSON: what LiteLLM priced the period's requests at in US dollars (amountUsd), split between agents' keys, inference API keys and keys of no known type (breakdown), the requests without a known caller (unattributedRequests), the prompt cache's use (cache) and each day's amount (daily). A Sunport OpenOrange bills answers billed_on_platform: what it charged is in oo billing balance and oo billing charges. The period is this month in UTC unless --query gives range (today, current_week or current_month), or from and to (its first and last day), and timeZone.

oo billing estimate [options]
ArgumentRequiredDefaultChoicesDescription
--query NAME=VALUEnoa period input; repeatable

It also takes the connection options.

oo billing server-budget

Read or change the Sunport's monthly server budget: what its agent VMs, service VMs and paid backups may cost in a month, in US dollars at list price. OpenOrange refuses a new VM that would take the month past it (server_budget_limit). Without options, print the budget, who set it, this month's servers so far and by the end of the month, and a change still on its way to OpenOrange. --set changes it; --default goes back to the plan's default. Changing it needs a person signed in as themselves, never an agent's key, and the change reaches OpenOrange within a minute. Clem changes it as the administrator who asks; raising it waits for an administrator's click.

oo billing server-budget [options]
ArgumentRequiredDefaultChoicesDescription
--set USDnothe new budget in US dollars, such as 250 or 99.50
--defaultnogo back to the default for the Sunport's plan

It also takes the connection options.

On this page