API ReferencePrivate Balance
Withdraw from encrypted balance to a public address
Move funds out of a managed wallet's encrypted balance to a public Solana address.
Authorization
ApiKey AuthorizationBearer <token>
In: header
Path Parameters
id*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/agents/v1/wallets/f47ac10b-58cc-4372-a567-0e02b2c3d479/withdraw" \ -H "Content-Type: application/json" \ -d '{ "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "1000000", "destinationPubkey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM" }'{
"queueSignature": "5h7Qw2KQz9oA3nP1cVxYtRb8sLmJ4dE6fGh9kU2wXcZ1aBpQ7rT3vN5mY8sD0fL2gH4jK6lM9nP1qR3sT5uV7w",
"callbackSignature": "5h7Qw2KQz9oA3nP1cVxYtRb8sLmJ4dE6fGh9kU2wXcZ1aBpQ7rT3vN5mY8sD0fL2gH4jK6lM9nP1qR3sT5uV7w"
}{
"error": "missing_required_fields"
}{
"error": "missing_required_fields"
}{
"error": "missing_required_fields"
}Shield + unlink — mixer round-trip to a fresh address
Four txs, ~60s. Public balance enters the Umbra mixer, a claim breaks the on-chain link, then withdraw + transfer delivers to a FRESH destination. Source and destination both appear on-chain but with no link between them. Use when you want destination unlinkability without converting tokens.
Encrypted-balance snapshot for given mints
Decrypt and return the managed wallet's encrypted balance for one or more mints (comma-separated).