Read balance or wallet status

Read seller balance and Connect flags, or wallet remaining allowance, depending on which key you pass.

Tool

rill_balance

With a seller key, this returns seller balance plus Connect readiness flags useful before withdraw. With a wallet key, it returns remaining period allowance and per-tx caps, the same data formerly exposed as rill_wallet_status.

Auth

Provide a seller key (rill_sk_*) or a wallet key (rill_vw_*). Session keys count. Missing both returns an error.

Parameters

Parameter	Type	Required	Description
`seller_key`	string	no	Seller key for balance and Connect flags
`vw_key`	string	no	Wallet key for allowance status

Usage notes

Pass exactly one principal (seller or VW), or rely on the matching session key.
Call with vw_key after pays to stay inside budget.
Seller path over HTTP: GET /sellers/me/balance. VW path: GET /wallets/me/status.