GET/POST /wallets

Managed wallets are custodial -- Suwappu holds the private key on your behalf so the server can sign and submit swap transactions without requiring you to manage keys or sign externally.


List Wallets

GET /wallets | Auth: Required

Retrieve all managed wallets associated with your agent.

Request

No parameters required.

Response

Field
Type
Description

success

boolean

Whether the request succeeded

wallets

array

List of wallet objects

Wallet Object

Field
Type
Description

address

string

The wallet address

chain_type

string

"evm" or "solana"

supported_chains

array

List of chain names the wallet supports (e.g., ["ethereum", "base", "arbitrum"])

Example Response


Create Wallet

POST /wallets | Auth: Required

Create a new managed wallet. No request body is needed. The server generates a new keypair and securely stores the private key for server-side swap execution.

Request

No body required.

Response (201 Created)

Field
Type
Description

success

boolean

Whether the request succeeded

wallet

object

The newly created wallet

Wallet Object

Field
Type
Description

address

string

The wallet address

chain_type

string

"evm" or "solana"

supported_chains

array

List of chain names the wallet supports

Example Response

Note: Managed wallets are custodial. Suwappu holds the private key so the server can sign transactions on your behalf via POST /swap/execute. You do not need to manage keys or submit raw transactions yourself.


Errors

Status
Error
Cause

401

"Unauthorized"

Missing or invalid API key

500

"Wallet creation failed"

Internal error during key generation


Code Examples

curl

Python

TypeScript

Last updated