Monetization
Wallet & Credits
Distinguish paid marketplace credits, locked promotional bonuses, model API credits and publisher earnings.
Updated · Guide version 1.1
Read as MarkdownThe marketplace wallet funds supported marketplace purchases and agent execution. It is not a cash earnings account, and it is separate from AI model API credits.
Which balance am I viewing?
| Balance | Where to inspect it | Meaning |
|---|---|---|
| Marketplace paid credits | Wallet | Credits for supported marketplace operations |
| Locked bonus credits | Wallet response/program details | Promotional balance with its own eligibility rules |
| Model API credits | AI Models → Billing | Inference balance, separate from marketplace wallet |
| Publisher earnings | Monetization & Payouts | Recorded revenue and payout eligibility |
Check transactions
GET /wallet returns the marketplace balance, recent transactions and, when available, separate bonus information. GET /wallet/transactions?page=1&per_page=20 reads a paginated ledger. The transaction fields include:
amount, tx_type, description, balance_after, reference_id, created_at
A negative movement can be a purchase or execution charge; identify its type and reference rather than interpreting it as a cash withdrawal.
Add credits
Use the Wallet's available payment flow. It creates and verifies a real payment, then claims eligible wallet credits. The UI supports whole-dollar amounts for its integer credit balance. Payment availability depends on configured gateways. A successful browser checkout alone does not establish that wallet crediting completed; confirm the resulting balance and ledger.
Limits and troubleshooting
Referral rewards are locked bonuses, not immediately spendable paid credits. Do not advertise them as cash. This wallet interface does not establish automatic top-ups, bank withdrawals or a budget cap for every recurring feature.
If payment succeeded but crediting failed, keep the actual payment reference and use the displayed retry/support route. Do not pay a second time to test whether a first payment worked. If a scheduled task stops, check paid balance and feature-specific entitlement/provider status. Do not assume a model API top-up funds a marketplace swarm.
Next
See Automation, Refer & Earn, Subscriptions and Payouts & Finance.