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

{
  "hl-key">"success": true,
  "hl-key">"wallets": [
    {
      "hl-key">"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
      "hl-key">"chain_type": "evm",
      "hl-key">"supported_chains": ["ethereum", "base", "arbitrum", "optimism"]
    },
    {
      "hl-key">"address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "hl-key">"chain_type": "solana",
      "hl-key">"supported_chains": ["solana"]
    }
  ]
}

---

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

{
  "hl-key">"success": true,
  "hl-key">"wallet": {
    "hl-key">"address": "0x9f8E163C2b4a1FA28cE3851F2B3D5C53bE6a4E71",
    "hl-key">"chain_type": "evm",
    "hl-key">"supported_chains": ["ethereum", "base", "arbitrum", "optimism"]
  }
}

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

-str">"hl-comment"># List wallets
-kw">curl https://api.suwappu.bot/v1/agent/wallets \
  -H -str">"Authorization: Bearer suwappu_sk_your_api_key"

-str">"hl-comment"># Create a wallet
-kw">curl -X POST https://api.suwappu.bot/v1/agent/wallets \
  -H -str">"Authorization: Bearer suwappu_sk_your_api_key"

Python

import requests

headers = {class="hl-str">"Authorization": class="hl-str">"Bearer suwappu_sk_your_api_key"}

class=class="hl-str">"hl-comment"># List wallets
response = requests.get(
    class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/wallets",
    headers=headers,
)
data = response.json()
if data[class="hl-str">"success"]:
    for wallet in data[class="hl-str">"wallets"]:
        print(fclass="hl-str">"{wallet[class="hl-str">'chain_type']}: {wallet[class="hl-str">'address']}")

class=class="hl-str">"hl-comment"># Create a wallet
response = requests.post(
    class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/wallets",
    headers=headers,
)
data = response.json()
if data[class="hl-str">"success"]:
    print(fclass="hl-str">"Created: {data[class="hl-str">'wallet'][class="hl-str">'address']}")

TypeScript

const headers = {
  Authorization: class="hl-str">"Bearer suwappu_sk_your_api_key",
};

class=class="hl-str">"hl-comment">// List wallets
const listResponse = await fetch(
  class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/wallets",
  { headers }
);
const listData = await listResponse.json();
if (listData.success) {
  for (const wallet of listData.wallets) {
    console.log(${wallet.chain_type}: ${wallet.address});
  }
}

class=class="hl-str">"hl-comment">// Create a wallet
const createResponse = await fetch(
  class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/wallets",
  { method: class="hl-str">"POST", headers }
);
const createData = await createResponse.json();
if (createData.success) {
  console.log(Created: ${createData.wallet.address});
}