# Filtering System

> Source: https://www.archr.bot/docs/filtering-system
> Section: Settings
> Last updated: 2026-07-27

**⚠️ Important**: Filters (market cap, holders, social) affect auto-buys. The Shield Filter has its own independent toggles for alerts and auto-buys — see below.

## Global vs Per-Channel Filters

By default, all signal sources use your **global filter settings**. You can override filters for any individual call channel, DEX signal type, or tracked wallet:

1. Go to **Settings → Signal Preferences**
2. Select the channel or signal
3. Tap **Filters**
4. Switch from **Global** to **Custom**
5. Configure channel-specific market cap, holders, social, and shield settings

This is useful when you want tighter filters for some channels and looser filters for trusted sources like specific wallets or high-quality call channels.

## Market Cap Filter

- **Minimum Market Cap**: Only consider tokens above specified value (e.g., $5K)
- **Maximum Market Cap**: Exclude tokens above specified value (e.g., $1M)
- **Custom Ranges**: Set your preferred market cap investment range

## Holders Filter

- **Minimum Holders**: Require minimum number of token holders (default: 1)
- **Distribution Analysis**: Avoid tokens with excessive whale concentration
- **Quality Control**: Filter out tokens with poor holder distribution

## Social Media Filter

- **Social Filter Toggle**: Enable or disable social filtering
- **Social Link Requirement**: When enabled, tokens need at least one Telegram or X/Twitter link

## ARCHR Shield Filter

The Shield Filter uses Jupiter's Shield API to detect potentially dangerous tokens. It has **three independent sub-toggles** in Settings → Shield Filter:

### 📢 Alert Blocking

Controls whether alerts are suppressed for tokens with Shield warnings.

- **OFF (default)**: You receive ALL alerts, including flagged tokens. Dangerous tokens show a "⚠️ Trade Anyway" button so you can choose to trade manually.
- **ON**: Alerts are suppressed entirely for tokens with any Shield warnings. Keeps your feed clean from risky tokens.

### 🤖 Auto-Buy Filter

Controls whether minor warnings block auto-buys.

- **Dangerous warnings ALWAYS block auto-buy** regardless of this setting (honeypots, wash trading, etc.)
- **OFF (default)**: Only dangerous tokens are blocked from auto-buy
- **ON**: Also blocks auto-buy for minor display warnings (very low trading activity, high supply concentration, high single ownership, low organic activity, transfer fees)

### 🔓 Bypass Low Organic Activity

Controls how the common "Low Organic Activity" warning is handled.

- **OFF (default)**: "Low Organic Activity" is treated like any other display warning — can suppress alerts (if Alert Blocking is ON) and block auto-buys (if Auto-Buy Filter is ON)
- **ON**: The "Low Organic Activity" warning is stripped entirely before any filter checks. It won't suppress alerts and won't block auto-buys. Many profitable tokens trigger this flag, so bypassing it lets them through while all other Shield warnings still apply.

### Warning Types

**Dangerous Warnings (Always Block Auto-Buy):**
- Honeypot detection
- Not sellable tokens
- Mint/Freeze authority issues
- Wash trading detection
- Hidden key holders
- Suspicious developer activity

**Minor Display Warnings (Blocked when Auto-Buy Filter is ON):**
- Very low trading activity
- High supply concentration
- Mutable transfer fees
- High single ownership
- Low organic activity
- Transfer fees

### Trade Anyway Flow

When you receive an alert for a dangerous token (with Alert Blocking OFF), you'll see:
1. The signal header (e.g., "🚨 New Token has Paid DEX!")
2. A security warning section listing the issues
3. Basic token info (name, market cap, holders)
4. **"⚠️ Trade Anyway"** and **"❌ Close"** buttons

Clicking "Trade Anyway" shows the full token information with buy buttons, allowing you to manually purchase despite the warnings.