Skip to main content

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 usesExamples
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​

SettingWhat it meansLimit
Instructions textThe prose your agent reads with every decision4,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​

FormWhen 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​

StatusMeaning
ResolvedToken replaced with the current value
UnknownToken doesn't match any indicator or rule — save fails
AmbiguousToken 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:

  1. Unique indicator header — matches if only one panel has that header
  2. Rule name — matches your strategy's rule names
  3. 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