> For the complete documentation index, see [llms.txt](https://zardoz.gitbook.io/zardoz-docs-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zardoz.gitbook.io/zardoz-docs-1/wallets.md).

# Wallets

## Wallets

Three kinds of wallets appear in Zardoz. They are **not** interchangeable.

### Overview

| Kind                        | Where in app                | Signs txs?       | Purpose                                 |
| --------------------------- | --------------------------- | ---------------- | --------------------------------------- |
| **Connected wallet**        | Top-right Connect           | Yes              | Primary trading & launch wallet         |
| **Trading wallets (vault)** | Portfolio → Trading wallets | Yes (local keys) | Bundle buys/sells across many addresses |
| **Watched wallets**         | /watch                      | No               | Track KOLs / smart money — read only    |

![Portfolio and wallet UI](https://zardoz.fun/docs/refs/Screenshot%202026-07-14%20220225.png)

### Connected wallet

#### Browser extension (MetaMask, Rabby, …)

* Connect via WalletConnect or injected provider
* Must be on **Robinhood Chain (4663)**
* Signs every main-panel trade and most launches
* MetaMask prompts for approve + swap separately

#### Google → Zardoz embedded wallet

* Sign in with Google; optionally generate an embedded wallet (`POST /api/wallet`)
* Private key encrypted server-side; unlocked in-session for signing
* `GET /api/wallet` returns address only — never the raw key in API responses
* Unlock from account menu before withdraw / wrap / sensitive ops

### Trading wallets (vault)

Device-local encrypted keys for **bundle trading** on token pages.

| Action      | How                                                                          |
| ----------- | ---------------------------------------------------------------------------- |
| Create one  | Portfolio → Trading wallets → Generate                                       |
| Mass import | Paste private keys (one per line) — download backup when prompted            |
| Fund        | Send RH ETH to each vault address before bundling                            |
| Use         | Token page → Bundle panel → pick wallets, fire presets                       |
| Tag DEV     | Mark wallets that bought in your launch bundle — enables “All excl DEV” dump |

{% hint style="danger" %}
Vault keys live in **your browser storage**. Clearing site data or switching devices without a backup loses those wallets permanently.
{% endhint %}

#### Trading wallets API

| Method | Path                   | Notes                                   |
| ------ | ---------------------- | --------------------------------------- |
| GET    | `/api/trading-wallets` | List vault wallets for session          |
| POST   | `/api/trading-wallets` | Add wallet `{ privateKey }` or generate |
| PUT    | `/api/trading-wallets` | Bulk update labels / DEV tags           |
| DELETE | `/api/trading-wallets` | Remove by address query                 |

Requires authenticated session.

### Watched wallets

Curated directory on [/watch](https://zardoz.fun/watch):

* **KOL** — influencers and public figures
* **Smart** — wallets flagged by on-chain behavior
* Filter search via `GET /api/watch/wallets?q=…&kind=kol|smart|both`
* Activity feed: `GET /api/watch/activity?limit=80&wallets=0x…,0x…`

You never sign for watched addresses — they feed Signals and Discover context only.

### Holdings & PnL

| Endpoint                                        | Params         | Returns                              |
| ----------------------------------------------- | -------------- | ------------------------------------ |
| `GET /api/holdings?address=0x…&network=mainnet` | Wallet address | ERC-20 balances via Blockscout proxy |
| `GET /api/pnl?address=0x…&network=mainnet`      | Wallet address | Realized / unrealized PnL summary    |
| `GET /api/wallet/{address}`                     | Path address   | Public wallet profile                |

### Funding checklist

1. Connected wallet has ETH for gas + trade size
2. Each vault wallet in a bundle has its own ETH (empty rows fail individually)
3. Launch flows may need **launch value + 0.002 ETH platform fee + gas**

Next: Trading · Bundle trading · Launching


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://zardoz.gitbook.io/zardoz-docs-1/wallets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.