Skip to content
Rival Docs

Run Balance

Overview

Run Balance is your execution quota - it’s consumed every time you run a tool or agent on Rival. Money you add with a Top Up, your plan’s monthly allotment, and referral credits all land here.

Money you earn from publishing - through Monetization and Refer & Earn - is tracked separately as earnings and withdrawn via Payouts, not spent from Run Balance.

View and manage your Run Balance at cortexone.rival.io/user/billings - the Run Balance card in the Overview tab shows your current quota and a Top Up button.

The two buckets

Run Balance is made up of two buckets:

Expirable

Granted from:

  • Your plan’s monthly allotment - $5 on Pro, $50 shared on Team, refilled each renewal
  • The $1 starter grant on Free Personal (one-time, not refilled)
  • Promotional credits

Expirable balance has an expiry date. Unused amounts are removed at expiry, and a renewal replaces what’s left rather than adding to it - an unspent allotment does not roll over.

Non-expirable

Granted from:

  • Top Ups - money you add to Run Balance with a card (minimum $5)
  • Manual grants

Non-expirable balance stays in your account through plan changes and cancellations.

When Run Balance is consumed

Every tool or agent execution debits Run Balance. The amount depends on the tool’s run cost (compute + any tool fee set by its creator). Each charge is recorded in the Transactions tab with status, payment method label, and date.

How to Top Up

  1. Open cortexone.rival.io/user/billings
  2. On the Overview tab, click Top Up on the Run Balance card
  3. Enter an amount and pay with a card
  4. Confirm - the amount lands in your non-expirable bucket immediately

When Run Balance is empty

When your Run Balance hits zero and you try to run a tool or agent, the request returns a 402 Payment Required response and the run is blocked. Your tools, agents, and data are untouched - only execution is paused.

To unblock yourself:

  • Top Up the Run Balance card (fastest, minimum $5)
  • Upgrade your plan for a larger monthly allotment - $5/mo on Pro, $50/mo shared on Team

On Team, buying an extra seat does not add balance: seats are capacity, the shared pool is separate. Top Up instead.

Next steps