> 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.