Skip to content

Funding your balance

A token carries a USDC-denominated balance. Each request is debited from it. You can fund a token two ways.

Open usepod.ai/fund, choose Card, and pay with an embedded Stripe Checkout. Card credits enter the same balance ledger as USDC deposits. A small processing surcharge is added on top of the credit you choose.

The dashboard at usepod.ai/fund handles this end to end — connect a wallet, choose USDC, approve. Behind the scenes it sends a DepositUsdc instruction to the sovereign program with your token’s deposit_code embedded, and the LiquidMirror credits your balance within seconds of finalization.

To deposit from a script or a wallet that signs custom transactions, build the instruction yourself — see Deposit on-chain for the full spec and ready-to-paste JS + Python snippets. A plain SPL USDC transfer with a memo will NOT be credited — the binding to your token lives inside the instruction data, not in a separate memo.

If you’d rather not hold a balance at all, x402 lets you pay for each request individually by sending USDC or SOL on Solana — no token, no top-up. It suits agents and one-off automated callers with a Solana wallet.

Every proxied response carries an X-Balance-Remaining header. You can also see balance and transaction history in the dashboard at usepod.ai/dashboard.

  • Balance is debited per request based on actual token usage at the selected provider’s price.
  • Spending is gated on a positive balance; a token with a zero balance is rejected before any upstream call.
  • To bound per-request cost, use Spend controls.