> For the complete documentation index, see [llms.txt](https://docs.raybot.app/start/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.raybot.app/start/web/wallet-search.md).

# Wallet Search

**Wallet Search** is an advanced wallet discovery tool that allows you to find specific addresses based on given parameters.\
In the hands of experienced traders, it helps quickly identify active players, KOLs, or even groups of connected participants.

### ✨ **Key features:**

* **Token-based search** — find wallets that have traded specified tokens.
* **Flexible filters** — set ranges for investments in SOL, PnL (in %), and timeframes (up to 30 days).
* **Up-to-date data** — PnL is recalculated every 5 minutes for maximum accuracy.
* **Result limit** — up to 250 wallets per query.

> *🎥 **Video example — exploring Wallet Search in 1 minute***

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/0p0yj90uyk>" %}

***

### 📎 Wallet Search — short explanation

**Wallet Search** helps you identify specific traders by matching their on-chain activity through recent token purchases. It’s a fast way to detect wallets by the “footprints” of their trades. \
Below is a simple 4-step workflow using FOMO DApp as an example.

#### **1. Gather data in FOMO**

Find the trader → open **Closed Positions**.\
Take the latest **3–4 SOL tokens**.\
**Important:** the most recent buy must be within the last **30 days**.

<figure><img src="/files/9K8nWX2lEkvLxUmdZ5nU" alt=""><figcaption></figcaption></figure>

For each token:\
— open **Transactions**,\
— select **one buy**,\
— **round the amount** (example: $499 ≈ 3.23 SOL → 3 SOL).

💾 Save:\
• token addresses\
• the amount of **one** buy (in SOL)

#### **2. Open RayBot WEB**

In Telegram send **/web** → open the web version → **Search Wallets**.\
Paste the token addresses.\
In **Amount → From (SOL)** enter the rounded single-buy amount.\
Start the search — RayBot will display wallets that traded the same tokens with the same buy size.

<figure><img src="/files/wJr8yGi9htyblTLLGA7x" alt=""><figcaption></figcaption></figure>

#### **3. Verify via Solscan**

Pick any wallet from the results.\
Open it on Solscan → expand all holdings → locate the **USDC** balance.

<figure><img src="/files/0RB0keKauxK3RGOQqRq1" alt=""><figcaption></figcaption></figure>

#### **4. Cross-check the balances**

Return to FOMO and compare the USDC balance shown in the app with the one on Solscan.\
If they match — you’ve found the trader ⚡️

<figure><img src="/files/GQAagwKu0lad1VQ01PAe" alt=""><figcaption></figcaption></figure>

This is the core logic behind **Search Wallets**.\
With a bit of creativity, you can uncover interesting wallets by matching recent positions of any trader from X, chats, or your community.


---

# 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:

```
GET https://docs.raybot.app/start/web/wallet-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.