Skip to Content
supedocs

Wallet and credits

One prepaid balance for every agent. 1,000 credits are $1.

Your workspace has one wallet. Every agent spends from it, and every call shows its price in credits before it runs.

1,000 credits = $1. A 3-credit search costs a third of a cent.

Add credits

On the dashboard, open Wallet and add between $5 and $1,000 by card. Save the card to turn on auto top-up: when the balance drops under an amount you set, supe adds credits, up to a monthly cap you choose.

What you're charged

  • The price is held while a call runs and charged only when it succeeds.
  • A failed call costs nothing. Neither does finding or inspecting a tool.
  • Some tools are priced per result. The answer's results says how many were counted.
  • A rented phone number or inbox costs its price the first month, then the same each month until you release it.

Check the balance

supe balance
99,999 credits available

Over HTTP, GET /v1/wallet returns balance, held (in calls still running) and available. Over MCP, wallet_balance.

When it runs out

A call the balance can't cover is refused with insufficient_balance (exit 5) and a link to add credits. You also get an email when the balance runs low.

Rentals

Phone numbers and inboxes your agents rent belong to your workspace:

supe rentals                 # what's rented, the monthly price, when each renews
supe rentals release <id>    # stop renewing one; it can't be undone, so it asks first

A released rental keeps working until the date it's paid through.

On this page