Rule Builder Bots

The Rule Builder is a bot template that lets you write your own entry logic as explicit IF-THEN rules — no code, no black box. You pick the conditions, the bot only enters when they're met, and every trade tells you exactly which conditions fired. This doc covers what the builder can express, what it deliberately can't, and how it behaves at the edges.

## Where It Lives

Go to **Bots → Create** and pick the **Rule Builder** template. Unlike the pre-built templates (ARB Hunter, Whale Copier, etc.), which come with fixed logic and a few knobs, the Rule Builder starts empty: you assemble the entry rule yourself.

## The Rule Model: IF-THEN

A rule is a set of **conditions** plus one **action**. On every evaluation cycle, the bot scans eligible markets, checks your conditions against each one, and executes the action on markets that pass. You can combine **up to 10 conditions** in a single rule.

Conditions are joined by one of two modes:

There is no mixed AND/OR nesting inside a single rule. That's a deliberate limit: nested boolean trees are where users stop being able to predict their own bot's behavior. If you need "A AND (B OR C)", build two rules as two bots — each stays auditable.

## The 9 Native Conditions

1. **AI edge ≥ X pp** — Predite's AI probability minus the market price, in percentage points. 2. **YES price ≤ X¢** — entry only below a price ceiling (cheap longshots, or "the market hasn't caught up yet"). 3. **YES price ≥ X¢** — entry only above a price floor (favorites, late convergence). 4. **Volume ≥ $X** — minimum market volume, your liquidity filter. 5. **Resolves in ≤ X hours** — only markets close to resolution. 6. **Resolves in ≥ X hours** — only markets with time left. 7. **Whale entered ≥ $X** — a whale position of at least $X was detected in this market. This reads the real on-chain whale feed — it reflects recent moves actually observed on-chain, not a live mirror of every wallet. 8. **Title contains term** — plain substring match on the market title. 9. **Category is X** — restrict to one category (Politics, Crypto, Sports, …).

## Actions: YES, NO, or Follow AI

The action is what the bot buys when conditions pass: **YES**, **NO**, or **Follow AI**. Follow AI buys whichever side Predite's probability engine favors for that market.

One honest edge case matters here: if a market passes your conditions but there is **no AI call** for it, a Follow AI rule **does not enter**. The bot never invents a direction. This will sometimes cost you an entry you "wanted" — that's the correct trade-off, because a coin-flip entry dressed up as an AI signal would be worse.

## Every Trade Explains Itself

Each trade the rule opens records a **trade reason** listing exactly which conditions matched (e.g. "edge 12.4pp ≥ 10pp; resolves in 41h ≤ 72h; whale $31k ≥ $25k"). When you review the bot a week later, you don't have to reconstruct why it fired — the trade tells you. This is the main reason to prefer the Rule Builder over opaque strategies: bad rules become visible, and fixable, fast.

## Exits Are the Bot's Standard Controls

The Rule Builder only decides **entries**. Exits use the same standard bot controls as every other template: stop-loss, take-profit, trailing stop, breakeven, and the pre-resolution exit (close before the market resolves instead of riding through settlement). This separation is intentional — entry logic is strategy-specific, but risk management shouldn't be reinvented per rule.

## Alert Only: Validate Before You Automate

Every rule has an **"Alert only"** checkbox. When checked, the rule doesn't trade at all — when conditions match, you get a notification (bell, Telegram, and push) instead of a position. Alerts are deduplicated to **one alert per market per 24 hours**, so a market hovering around your threshold won't spam you.

Use this as a cheap validation pass: run the rule in alert-only mode for a week, and check whether the markets it flags are ones you'd actually want to enter. It's faster feedback than paper trading and costs nothing.

## Failure Behavior

If a ruleset is invalid or becomes corrupted (e.g. a condition references a value that no longer parses), the bot **never opens positions** on it. Failing closed is the only acceptable default for something that spends money: a broken rule produces zero trades, not undefined trades.

## Publishing and Forking

Rule Builder bots work with the strategy marketplace like any other bot: you can **publish** yours, and others can **fork** it. Forking copies the configuration — the full ruleset, conditions, and action — into the forker's account, where they can edit it freely. Your live positions, balances, and trade history are never shared.

## Limits Worth Knowing

## Related Docs