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

# AFK Trade

AFK Trade is an advanced, fully **automated trading execution module.** It allows users to set up pre-programmed trading strategies that monitor, filter, and execute trades

Instead of sitting in front of charts 24/7, you can define systematic rules using a modular, node-based structure. Once deployed, the MevX execution engine runs tirelessly in the background to capture on-chain opportunities and manage your risk while you are safely AFK

{% hint style="info" %}
Try now: <https://mevx.io/afk-trade>
{% endhint %}

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

### 1. System Architecture & Node Configurations

The AFK Trade system operates as a sequential pipeline, consists of different nodes. To set up your strategy, you can use the following nodes:

#### 1.1. Trigger Node (If)

The Trigger Node serves as the **automated ignition** switch for your AFK trading strategy. It is responsible for continuously monitoring real-time on-chain and off-chain data feeds, instantly dispatching an activation signal to kickstart the trading flow the exact moment your predefined conditions are met.

**System Properties & Rules**

* **Mandatory Component**: Every single flow must include a Trigger Node. It always functions as the absolute starting point of the pipeline.
* **Multi-Trigger Logic ("OR" Condition)**: A single trading flow can be activated by one or multiple Triggers simultaneously using "OR" logic. If *any* of the selected triggers fire, the flow executes.
  * *Example 1:* A "Bonded Flow" is activated only when the Token Migrated event is triggered.
  * *Example 2:* An "Alpha Pulse Flow" can be activated when either the KOL Fomo event OR the X Call event is triggered.

**Supported Trigger Events & Configurations**

<table><thead><tr><th width="169">Event Type</th><th>Description</th><th>Additional Configuration</th></tr></thead><tbody><tr><td>Token deployed</td><td>Fires the exact second any new token is created on an integrated launchpad (e.g., Pump.fun).</td><td>None</td></tr><tr><td>Token migrated</td><td>Fires immediately when any token successfully completes its bonding curve and migrates to a primary AMM (e.g., Raydium).</td><td>None</td></tr><tr><td>MC milestone</td><td>Triggers when a token hits one or more specific Market Cap thresholds for the first time.</td><td>Reached: <em>Input - Multi-Select</em> (Define target MC milestones).</td></tr><tr><td>ATH</td><td>Fires the moment a token breaks its All-Time High (ATH) price or highest recorded Market Cap.</td><td>None</td></tr><tr><td>Price Shift</td><td>Triggers when a token experiences a sudden, drastic price fluctuation within a 5-minute interval.</td><td><p>Change: <em>Input - Percentage (%)</em></p><p>• <em>Positive value:</em> Price surge is <span class="math">$\ge$</span> user expectation.</p><p>• <em>Negative value:</em> Price drop is <span class="math">$\le$</span> user expectation.</p></td></tr><tr><td>Volume Spike</td><td>Triggers when a token's trading volume grows sharply within a 5-minute window.</td><td>Increase: <em>Input - Percentage (%) - Positive Only</em> (Volume spike is <span class="math">$\ge$</span> user expectation).</td></tr><tr><td>Dex Ad</td><td>Fires when a token purchases a Paid Advertising package on DexScreener that matches your tracking criteria.</td><td>Package: <em>Multi-select</em> ($299, $699, $999, $1999, $3999, $6999).</td></tr><tr><td>Dex boost</td><td>Triggers when a project buys a score-boosting package on DexScreener to increase visibility.</td><td>Pack: <em>Multi-select</em> (10, 30, 50, 100, 500 score packs).</td></tr><tr><td>CTO</td><td>Triggers instantly when a token is officially marked as a Community Takeover (CTO) on DexScreener.</td><td>None</td></tr><tr><td>Pump Live</td><td>Fires the moment a token creator starts a live streaming session on Pump.fun.</td><td>None</td></tr><tr><td>Smart Money Buy</td><td>Triggers when any wallet from the curated <em>Smart Money List</em> buys a token.</td><td>Min amount: <em>Input - Number</em> (Fires only if transaction volume is <span class="math">$\ge$</span> Min amount).</td></tr><tr><td>KOL Fomo</td><td>Triggers when any tracked Influencer/KOL wallet executes a buy order on a token.</td><td>Min amount: <em>Input - Number</em> (Fires only if transaction volume is <span class="math">$\ge$</span> Min amount).</td></tr><tr><td>X Call</td><td>Scans X (Twitter) profiles in real-time. Triggers when a Contract Address (CA) or Liquidity Pool (LP) link is detected.</td><td>X Handle: <em>Input - Text</em> (Monitors custom Tweets, Retweets, Replies, or Bio Updates from specified handles).</td></tr><tr><td>TG Call</td><td>Scans selected Telegram alpha channels. Triggers instantly when a new message containing a CA/LP is detected.</td><td>TG Channel ID: <em>Multi-select</em> (Choose from available Telegram tracking channels).</td></tr></tbody></table>

#### 1.2. Filter Node (When)

The Filter Node acts as a strict screening barrier that decides whether the automated trading flow should proceed to execution or terminate immediately.

When a transaction pipeline enters this node, the system validates every single programmed parameter simultaneously:

* All Conditions Met: The flow safely transitions to the next node in the sequence.
* At Least One Condition Fails: The flow is forced to stop immediately, resetting the bot.

**System Properties & Rules**

* Optional Component: This node is non-mandatory. You can choose whether or not to include a Filter Node in your automated workflow.
* Strict "AND" Logic: There is no limit to the number of safety criteria you can stack. However, when multiple filters are active, the system processes them using strict "AND" logic—every single checkbox and numerical range must return a true value to pass.

**Supported Filter Fields & Criteria**

<table><thead><tr><th width="122.80001831054688">Field</th><th>Matching Logic &#x26; Description</th></tr></thead><tbody><tr><td>Symbol</td><td><p>Contains: Token symbol contains specific keywords (Case-insensitive).</p><p></p><p>Exact: Token symbol matches the keyword exactly (Case-insensitive).</p></td></tr><tr><td>Name</td><td><p>Contains: Token name contains specific keywords (Case-insensitive).</p><p></p><p>Exact: Token name matches the keyword exactly (Case-insensitive).</p></td></tr><tr><td>Exchanges</td><td><p>Evaluates integrated Launchpads &#x26; DEXs on the current chain:</p><p></p><p>• For Launchpads: Passes if the token was deployed on at least one selected launchpad (including migrated assets).<br></p><p>• For DEXs: Passes if the liquidity was manually added or successfully migrated to at least one selected DEX.</p></td></tr><tr><td>Market Cap</td><td>Filters tokens based on their live Market Capitalization boundaries.</td></tr><tr><td>24h Volume</td><td>Filters based on the token's 24-hour trading volume.</td></tr><tr><td>Liquidity</td><td>Evaluates the total liquidity available in the pool.</td></tr><tr><td>Dev Buy</td><td>Tracks the initial buying volume or order sizing executed by the token deployer/developer.</td></tr><tr><td>Txs</td><td>Evaluates the total number of transaction counts within the market.</td></tr><tr><td>Holders</td><td>Filters based on the minimum or maximum total unique holding addresses.</td></tr><tr><td>Snipers</td><td>Tracks the absolute number of automated sniper bots that entered at block zero.</td></tr><tr><td>24h Bot Traders</td><td>Filters by the number of algorithmic bot addresses active over the last 24 hours.</td></tr><tr><td>Dev Holding</td><td>Restricts execution based on the percentage of supply still held by the developer's wallet.</td></tr><tr><td>Top 10 Holding</td><td>Measures token distribution safety by filtering the combined supply percentage owned by the Top 10 holders.</td></tr><tr><td>Sniper Holding</td><td>Filters out tokens where sniper wallets control an unsafe cumulative percentage of the supply.</td></tr><tr><td>Insider Holding</td><td>Screens assets based on the supply percentage allocated to identified insider/cabal wallets.</td></tr><tr><td>Bundler Holding</td><td>Evaluates the total supply cluster controlled by supply-bundling architectures.</td></tr><tr><td>Dev Bundler Holding</td><td>Tracks the explicit subset of bundled tokens tied directly to the developer profile.</td></tr><tr><td>Phishing Holding</td><td>Monitors and filters based on supply allocation trapped in known phishing or malicious draining nodes.</td></tr><tr><td>Has Dex Ad</td><td>Passes only if the token currently has an active, valid advertisement package running on DexScreener.</td></tr><tr><td>Has Dex boost</td><td>Passes only if the project currently has an active, valid score-boosting package running on DexScreener.</td></tr><tr><td>Has Community Takeover (CTO)</td><td>Passes only if the token has been officially verified and updated as a Community Takeover (CTO) project on DexScreener.</td></tr></tbody></table>

#### 1.3. Action Node (Then)

The Action Node is the execution engine of your AFK trading strategy. Once a token successfully fires your predefined Triggers and safely clears your active Filters, this node takes over to execute live on-chain transactions instantly without requiring manual approval.

**System Properties & Rules:**

* Mandatory Component: Every single automated flow must include an Action Node to successfully deploy.
* Multiple Actions ("AND" Logic): There is no limit to the number of executions you can stack within a single node. When multiple actions are configured, the system processes them sequentially using strict "AND" logic—meaning all specified actions will be carried out one after the other.

**Supported Execution Actions & Configurations**

**Buy Action**

Instantly executes a market buy order for the specific token that triggered and passed through the active trading flow.

Available Configurations:

* Wallets: *Multi-select* (Choose one or multiple integrated wallets to deploy capital).
* Amount: *Input - Number* (Specify the fixed amount of native currency, e.g., SOL, to spend per wallet).
* Slippage: *Input - Number %* (Set the maximum price slippage percentage you are willing to tolerate).
* Fees: *Input - Number* (Configure your custom Jito Tip and Priority Fees to ensure rapid block inclusion).
* TP/SL (Optional): Attach standard Take Profit and Stop Loss price execution targets to this position.
* Trailing SL (Optional): Attach a dynamic Trailing Stop Loss strategy with a fixed Trailing Delta to follow price rallies.

**Sell Action**

Instantly executes a market sell order for the token managed within the active trading flow.

* Strict Operational Rule: A Sell Action must always be positioned chronologically *after* a valid Buy Action node within the pipeline.
* Available Configurations:
  * Wallets: *Multi-select* (Choose which holding wallets will execute the liquidation).
  * Amount: *Input - Number %* (User inputs the sell size as a percentage, e.g., 50% or 100%. The system dynamically calculates the exact token amount based on the actual tokens successfully acquired in the immediate preceding Buy Action).
  * Slippage: *Input - Number %* (Set your maximum acceptable slippage tolerance for the exit).
  * Fees: *Input - Number* (Configure priority fees and Jito tips to outpace market congestion during liquidation).

#### 1.4. Watcher Node

The Watcher Node acts as a dynamic, conditional waiting room that enables advanced multi-branching logic within your trading pipeline.

Unlike a Filter Node (which instantly decides whether to terminate or continue the flow), a Watcher Node temporarily pauses the execution stream. It continuously monitors live data feeds in the background until all preset conditions are fully satisfied before safely releasing the flow to the next node.

**System Properties & Rules:**

* Optional Component: This node is non-mandatory. You can choose whether or not to incorporate a Watcher Node into your workflow architecture.
* Multi-Branching Execution ("OR" Logic Between Sets): You can configure multiple condition sets within a single Watcher. Each set splits the pipeline into independent, parallel sub-branches. Whichever condition set fully satisfies its criteria first will execute its respective branch immediately and cease monitoring for that specific path. Any remaining unsatisfied sets will continue to be tracked by the bot.
* Intra-Set Validation ("AND" Logic Within a Set): If a specific condition set contains multiple individual rules, the system processes them using strict "AND" logic—meaning every single metric inside that specific set must be simultaneously true to trigger the branch.
* Placement Rule: A Watcher Node can be inserted at any point in the workflow pipeline as long as it is positioned *after* the initial Trigger Node and terminates into a valid Action Nod

**Supported Watcher Metrics & Conditions**

<table><thead><tr><th width="127"></th><th></th></tr></thead><tbody><tr><td>Market Cap (Above)</td><td><em>Input Number (</em><span class="math">$> 0$</span><em>)</em>: Condition is satisfied the exact moment the token's live Market Cap breaks above your custom threshold.</td></tr><tr><td>Market Cap (Below)</td><td><em>Input Number (</em><span class="math">$> 0$</span><em>)</em>: Condition is satisfied the exact moment the token's live Market Cap drops below your custom threshold.</td></tr><tr><td>Price Change</td><td><em>Input % (</em><span class="math">$> -100\%$</span><em>)</em>: Condition is satisfied as soon as the token's cumulative percentage price shift expands past your custom target.</td></tr><tr><td>24h Vol</td><td><em>Input Number (</em><span class="math">$> 0$</span><em>)</em>: Condition is satisfied when the token's trailing 24-hour trading volume exceeds your defined milestone.</td></tr></tbody></table>

```
```


---

# 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.mevx.io/docs/feature-ecosystem/afk-trade.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.
