> For the complete documentation index, see [llms.txt](https://docs.cielo.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cielo.finance/wallet-tracking/research-agents.md).

# Research Agents

The [Research Agents](https://trading.cielo.finance/agents/research) page lets you spin up a watcher that pings you the moment a specific onchain pattern fires. Pick a trigger, tune the filters, point it at a Telegram bot or Discord channel, and the agent does the watching so you can focus on the trade.

Each agent does one job: it watches the chain for a specific signal and posts an alert when it fires.

{% hint style="info" %}
Research Agents work alongside your existing Cielo alerts. You can route each agent to a different Telegram bot or Discord channel so the signals stay sorted.
{% endhint %}

### Creating an agent

From the Research Agents page, click **Make an agent** (or **Make my first agent** if you don't have any yet). The wizard walks you through five steps:

1. **Trigger** - Pick which onchain pattern should fire this agent.
2. **Filters** - Tune the trigger. Each trigger has its own filter set.
3. **Output** - Pick a Telegram bot, a Discord channel, or both. You need at least one to continue.
4. **Name** - Give the agent a short label so you recognise it at a glance.
5. **Preview** - Review the configuration and see a sample alert. Click **Activate agent** to go live.

Once active, the agent runs immediately and starts posting to your chosen channels.

### Available triggers

* [**CEX Fresh Buy** ](/wallet-tracking/research-agents/cex-fresh-buy.md)*(Whale)* - brand-new CEX-funded wallet bought above $1k on its first token
* [**Fresh Wallet Buy** ](/wallet-tracking/research-agents/fresh-wallet-buy.md)*(Whale)* - newly funded wallet accumulates a token
* [**Your Wallet Funded a New Wallet**](/wallet-tracking/research-agents/your-wallet-funded-a-new-wallet.md) *(Pro+Whale)* - a tracked wallet funds a fresh wallet
* [**KOL Cluster Buy** ](/wallet-tracking/research-agents/kol-cluster-buy.md)*(Free)* - three or more verified KOLs buy the same token in a chosen timeframe
* [**FOMO Cluster Accumulation**](/wallet-tracking/research-agents/fomo-cluster-accumulation.md) *(Whale)* - three or more FOMO-app smart-money wallets net-accumulate the same token in a chosen timeframe
* [**Top Holders Supply Change**](/wallet-tracking/research-agents/top-holders-supply-change.md) *(Pro+Whale)* - the top-20 holders' combined share of supply moves by ≥X% in a rolling window (fires on both accumulation and distribution)

### Popular starting points

The Research Agents landing page surfaces three quick-start cards at the bottom: **Your Wallet Funded a New Wallet**, **CEX Fresh Buy**, and **KOL Cluster Buy**. Clicking any of them opens the wizard pre-loaded with that trigger.

### Output channels

In the **Output** step, pick where alerts should publish.

* **Telegram**: choose one of your Cielo Telegram bots from the dropdown. Free users have one bot, Pro users two, Whale users get more. See [Telegram](https://docs.cielo.finance/discord-+-telegram-bots/getting-started) for setup.
* **Discord**: click **Connect** to link your Discord. See [Discord](https://docs.cielo.finance/discord-+-telegram-bots/discord) for setup.

You need at least one channel selected. Leave the other one empty to skip it.

### Coming soon

A few triggers are visible in the wizard but tagged **Soon** and not yet live:

* **Dormant Awakening** *(Pro+Whale)* - a sleeping wallet trades again
* **Strong Floor** *(Pro+Whale)* - price holds while holder count rises

The **Templates** and **Activity** tabs on the Research Agents page are also coming soon. Templates will let you spin up agents from saved configurations, and Activity will give you a feed of everything your agents have fired.

 


---

# 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.cielo.finance/wallet-tracking/research-agents.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.