Skip to main content
Kviria is paid with x402: USDC on Base, into a prepaid balance that belongs to your Kviria account. There is no card. A wallet only pays: any wallet can top up your account.

​
How it works

An account without a balance gets 600 free turns a day. After that, a call gets a 402 with free_daily_limit_exhausted and the payment requirements, and a payment tops up the account’s balance. While the account has a balance, every turn costs $0.01 from it, a paid turn does not use the free turns, and the account gets 1,800 turns a minute. Connect and pay gives the steps. Only an answered turn is charged. A turn that answers with an error, such as a 400, costs nothing, and so does a turn outside coverage.

​
The pricing document

It returns the price per turn, the top-up options and the payment requirements: the network, the asset and the receiving address. That is everything an x402 client needs to build a payment.

​
Notes

  • A payment rides on a call that carries your key or OAuth token. A payment with neither gets the 401.
  • A payment is credited once, to the account that sent it first. The same payment sent again, by any account, is refused with payment_rejected:already_claimed.
  • A payment that failed to settle can be sent again by the same account, 30 seconds after the last attempt.
  • An account can send 5 payments a minute (429 payment_rate_limit).
  • A paid turn’s response carries the x-kviria-balance-remaining header.
  • A refused payment is a 400: payment_rejected: followed by the reason, or payment_settle_failed.
  • The same headers work on the MCP server.