Agent instructions: guiding your agent's decisions
Agent instructions are plain-language guidance your agent reads with every trading decision. They shape how the agent weighs evidence and interprets your strategy — like standing orders to a human trader.
Quick start: what to write
Agent instructions work best for:
| Good uses | Examples |
|---|---|
| Priorities | "Prefer structure breaks over short-term RSI signals" |
| Context | "This strategy targets volatile altcoins during BTC consolidation" |
| Reminders | "Size down when funding is extremely positive" |
| Interpretation | "Treat conflicting momentum signals as a no-trade" |
Not for: Hard rules you need enforced (use Rules instead), specific price levels (use Trade levels), or exit timing (use Exit).
How it works
Your agent reads the instructions alongside:
- The Agent briefing (indicator values, rule outcomes)
- The current market context (price action, regime)
- Your rules and their pass/fail status
The agent uses your instructions to interpret ambiguous situations. Instructions don't override your rules — they guide judgment when rules don't dictate the answer.
Settings
| Setting | What it means | Limit |
|---|---|---|
| Instructions text | The prose your agent reads with every decision | 4,000 characters |
Empty instructions are allowed. Your agent will still follow your rules and policy settings — it just won't have additional guidance.
Worked example: momentum strategy instructions
Strategy: Breakout momentum on altcoins
Instructions:
Focus on volume confirmation. RVOL above 1.5 adds conviction; below 0.8 suggests the move lacks participation.
When RSI and MACD conflict, favor the higher timeframe signal. 4h momentum matters more than 1h noise.
During high positive funding (above 0.05%), reduce size or wait for a pullback entry. Crowded longs often squeeze.
If BTC is down more than 2% on the day, treat all altcoin longs as lower conviction.
What the agent does:
- Checks RVOL when evaluating breakouts
- Defers to 4h signals when 1h and 4h disagree
- Sizes down when funding is elevated
- Adds caution to longs during BTC weakness
Note: These instructions guide interpretation. If you need RVOL > 1.5 enforced, add it as a Must-pass rule instead.
Live values
Insert current indicator readings into your instructions using {tokens}. The agent sees the actual values at decision time.
Syntax
| Form | When to use |
|---|---|
{header} | When the header is unique across the Agent briefing |
{section.header} | When the same header appears in multiple panels |
Examples
Only trade when {vol24hUsd} exceeds $1M.
If {SQUEEZE_ON} is true and {Momentum.pctB20} shows release, look for entry.
Wait for {RSI14} to leave oversold before going long.
What tokens resolve to
| Status | Meaning |
|---|---|
| Resolved | Token replaced with the current value |
| Unknown | Token doesn't match any indicator or rule — save fails |
| Ambiguous | Token matches multiple sources — use qualified form |
The builder shows resolution status as you type. Fix any unknown or ambiguous tokens before saving.
Good to know
-
Instructions aren't enforced. They guide judgment, not gates. For hard requirements, use Must-pass rules.
-
Preview before saving. Use the preview to see how your instructions read with actual values inserted.
-
Keep it concise. 4,000 characters is the limit, but shorter and clearer is better. Your agent reads this on every decision.
-
Update with your strategy. When you change indicators or rules, review your instructions — references to removed elements won't resolve.
Advanced: Token resolution details
Resolution priority
When a token could match multiple sources:
- Unique indicator header — matches if only one panel has that header
- Rule name — matches your strategy's rule names
- Qualified form —
{section.header}always matches the specific panel
Collision handling
If a rule name matches an indicator header exactly:
- Bare
{KEY}is ambiguous — rejected {section.KEY}selects the indicator- The rule cannot be referenced by token
Fix: Rename the rule to something unique.
Preview lens
In the builder, token values resolve against a preview coin you select. Without a preview coin, you see token names but not values.
Advanced: UI terminology note
The Strategy Builder may show this feature as "Standing Orders" in some places. "Agent instructions" and "Standing Orders" refer to the same thing — the prose guidance your agent reads.
← Indicators · Rules · Trade levels