Credits and wallets
One credit is one cent. Spend comes out of two separate wallets, both held at the organization level, and every paid response tells you what it cost and what is left. Failed calls cost nothing, so a retry loop cannot quietly drain a balance.
Two wallets
Data spend and model spend are metered separately, because they scale for different reasons. Both wallets belong to the organization and are shared by every workspace inside it, so moving work between workspaces never strands a balance.
| Wallet | Pays for | Overdraft |
|---|---|---|
| data | Curated data sources and every other per-call data charge, priced per call, per endpoint. Your-credential connections do not draw on it — they are recorded at zero. | none, the call is refused first |
| ai | Model input and output tokens, cache reads and writes, tool use, and managed-agent runtime seconds. | may dip slightly negative |
Per-call prices for the curated sources are not fixed platform-wide. Each endpoint carries its own cost: read it from GET /v1/platforms or on the endpoint page in the API reference. The workspace database is not metered at all: the /v1/db/* routes deduct no data credits.
How a charge is applied
A data charge is resolved in three moves, in this order.
- 01The organization discount is applied first. It is the best discount across every active subscription, so a credit commitment or credit package covers every data call the organization makes.
- 02The monthly subscription allowance drains next. Credit-package allowances go first, oldest first, and the feature plan's allowance last. Allowances refill each billing period.
- 03Whatever is left debits the purchased balance, which never expires.
The discount applies to data spend only. AI spend drains the feature plan's AI allotment first and then the purchased AI balance, at the metered rate.
the two overdraft rules differ
The data wallet cannot go negative. If the discounted cost exceeds allowance plus purchased balance, the request returns INSUFFICIENT_CREDITS with HTTP 402 before the upstream provider is contacted, so you are never charged for a call that was going to be refused.
The AI wallet is allowed to dip slightly negative. A response already streaming is never cut mid-token to settle a rounding race; the small shortfall lands on the purchased AI balance and clears on the next top-up.
Failed calls cost nothing. A data call that errors is recorded at zero cost, and calls through your own vendor credentials are always recorded at zero because you are paying the vendor directly.
Free credits
Every new organization starts with $0.50 on the data wallet. It is enough to make a handful of real calls and see the metering work end to end before any card exists.
The onboarding flow pays $0.25 per claimed action, flat, once per organization per action.
| Action | Pays |
|---|---|
| Follow on X | $0.25 |
| Follow on LinkedIn | $0.25 |
| Subscribe on YouTube | $0.25 |
| Tell us where you heard about us | $0.25 |
A credit package is a monthly data-credit allowance that also carries a standing discount and a one-time signup bonus. The bonus lands on the purchased balance and never expires.
| Package | Price / mo | Data credits / mo | Discount | One-time bonus |
|---|---|---|---|---|
| Data Credits Small | $29 | $29 | 10% | $10 |
| Data Credits Standard | $99 | $99 | 15% | $33 |
| Data Credits Large | $299 | $299 | 20% | $100 |
Buying credits
Top-ups happen in the dashboard at app.superagnt.com. You pick the wallet, then the amount. The minimum purchase is $10, and the quick-buy presets are $25, $50, $100 and $250; any amount at or above the minimum works.
- Purchased credits never expire. They sit on the organization balance until something spends them.
- Top-ups are per wallet. Buying data credits does not fund model spend, and the reverse is also true.
- Invoices, receipts and saved cards live in the Stripe billing portal, opened from the billing page.
Auto-reload
Auto-reload is configured per organization and per wallet: a threshold and a reload amount, each wallet independently. When a debit takes the balance below the threshold, the saved card is charged for the reload amount. It needs a card already on file, and the reload amount is subject to the same $10 minimum as a manual purchase.
A short cooldown sits between consecutive attempts on the same wallet, currently 60 seconds. That is what stops a burst of concurrent calls from queueing several charges at once: the first debit to cross the threshold claims the slot, and its siblings do nothing.
Who can spend
Buying credits, changing auto-reload, changing the plan and adding seats are restricted to organization owners and admins. A member who tries gets a 403 saying so. Everyone in the workspace can read the balance and the usage history.
agents never move money
Reading your balance
GET /v1/credits returns the data wallet: the purchased balance, the remaining subscription allowance, and the recent credit-transaction ledger.
curl "https://api.superagnt.com/v1/credits" \
-H "Authorization: Bearer $AGNTDATA_API_KEY"You rarely need to poll it, because every paid call already carries the balance back inline. A successful response puts the cost of that call and both data-wallet figures in meta.
{
"success": true,
"data": { /* ... */ },
"meta": {
"costCents": 1.5,
"purchasedBalanceCents": 4248.5,
"subscriptionRemainingCents": 1800,
"cached": false,
"latencyMs": 412
}
}From inside an agent session, agnt_credits_balance returns the same data-wallet figures plus their total, so an agent can check whether it can afford a batch before starting one. For AI spend and a full breakdown across both wallets, see Usage.