API ReferenceManaged Wallets
Run a private swap from a managed wallet (Mode A)
Execute a private swap funded by a managed wallet's balance. Returns a session id to poll; no client-side signing needed.
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
curl -X POST "https://example.com/agents/v1/wallets/f47ac10b-58cc-4372-a567-0e02b2c3d479/swap" \ -H "Content-Type: application/json" \ -d '{ "fromMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "toMint": "So11111111111111111111111111111111111111112", "amount": "1000000", "destinationPubkey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "slippageBps": 50 }'{
"sessionId": "b3d9a1e2-5c4f-4a8b-9e7d-1f2a3b4c5d6e",
"status": "running",
"estimatedSeconds": 70
}{
"error": "missing_required_fields"
}{
"error": "missing_required_fields"
}Build an unsigned funding tx for the agent to sign
Returns an unsigned base64 transaction that moves tokens from the agent's own wallet into the managed wallet. The agent signs and broadcasts it.
Wallet operation audit log
Chronological audit log of every operation on a managed wallet (created, swap, encrypt, shield, withdraw), newest first.