Overview

This section covers the controls and audit trail attached to a custody wallet: wallet policies that gate every wallet operation, and balance visibility. A wallet policy applies uniformly across payment, ramp, issuance, signing, and on-chain program activity such as Earn vault deposits, whichever product flow initiates the request.

What's in this section

• Wallet policies — configure default decisions, destination controls, amount limits, operation permissions, approval requirements, and audit visibility.
• Wallet balances — retrieve token balances and optional USD valuations for a custody wallet.

API surface

The current wallet-policy and balance endpoints remain under /v1/payments/wallets because they were introduced with the Payments API. Their behavior is wallet-wide: policy operation families include transfer, payment, ramp, issuance, and program.

Related

• Set up wallets — provision the wallet before configuring controls.
• Payments — payment and ramp flows that can use a policy-controlled wallet.
• Manage API keys — an API key policy narrows or routes to approval; it never expands what the wallet policy allows.