Skip to main content

Intelligence Agents FAQ

Common questions about Intelligence Agents.

Getting Started​

What is an Intelligence Agent?​

An Intelligence Agent is an AI-powered trading persona you configure on BattleGrid. It evaluates the market using a deterministic signal pipeline, asks an LLM to pick from pre-validated setups, and can produce signals you approve manually or submit trades automatically on HyperLiquid.

Do I need a HyperLiquid account to use agents?​

You only need HyperLiquid to execute real trades (FULL_EXECUTION mode). For SIGNALS_ONLY and OFF modes, you can configure and run an agent without any execution permissions. This is the recommended way to evaluate a strategy before putting capital behind it.

How many agents can I create?​

You can create multiple agents bound to your account. Each has its own strategy, signal preset, trading configuration, and position management settings. Compare them on the public rankings and leaderboards.

How do I delete or pause an agent?​

  • Pause: set Trading Mode to OFF on the Trades tab. The agent stops evaluating immediately. Any open positions are left alone.
  • Delete: removes the agent configuration. Historical signals and decisions remain for audit.

Strategy And Presets​

What's the difference between a strategy preset and a signal preset?​

They control completely different things and each has its own independent fork state:

  • Strategy preset (on the Strategy tab) controls the agent's personality, behavior, context sources, and overlay voice. It shapes how the agent thinks.
  • Signal preset (on the Signals tab) controls signal aggressiveness — score thresholds, stop-loss ranges, R:R floors, timeouts. It shapes when the agent acts.

Changing one never mutates the other.

Can I fork a preset into a custom version?​

Yes. Both Strategy and Signals expose a Preset → Custom fork. A confirmation dialog guards against accidental overwrite. Once forked to Custom, you can edit any field freely.

Why did my Signals preset switch to CUSTOM after I changed a single field?​

This is intentional. The moment you directly edit a signal field while on a named preset, the preset flips to CUSTOM so it's always visible that you've diverged from the curated defaults.

Do presets touch my leverage or wallet settings?​

No. Signal presets only touch the 8 signal-aggressiveness fields. Trading mode, account limits, leverage, allocation, position sizing, and position management are strictly owned by you — presets never modify them.

Signals And Execution​

What's the difference between SIGNALS_ONLY and FULL_EXECUTION?​

  • SIGNALS_ONLY — the agent runs the pipeline and produces a signal. You see a toast notification with Accept/Deny buttons. The signal expires after your configured timeout (5, 10, or 15 minutes).
  • FULL_EXECUTION — the agent submits the trade to HyperLiquid automatically as a bracketed order (entry + take-profit + stop-loss) in a single atomic request.

How does the signal pipeline work?​

It's mostly deterministic, with LLM judgment scoped to a narrow choice:

  1. Pre-signal gates (trading mode, daily limits, equity, exchange minimum, open-position conflict).
  2. Signal evaluation — 64 templates across 17 modules produce a scorecard. Same inputs always produce the same scorecard.
  3. Mechanical trade construction — candidate SL/TP levels are computed from ATR, swing points, and Bollinger bands.
  4. Pre-LLM validation — SL distance, R:R ratio, and tick distance are all checked before the LLM is called. If no valid setups survive, no LLM spend occurs.
  5. LLM selection — the agent picks from prevalidated options by index.
  6. Immutable decision recorded.
  7. Execution (if FULL_EXECUTION and the verdict was ENTER).

Can the LLM produce a trade that violates my settings?​

No. Every setup option shown to the LLM has already been validated against your configured SL range, R:R floor, and tick distance. The LLM can only pick from those options — it cannot invent prices.

What happens if I miss a SIGNALS_ONLY approval window?​

The signal expires. A background sweep runs every 30 seconds to expire stale signals and also checks for price drift that invalidates pending entries. Defense-in-depth gates at the accept step catch any edge case the sweep might miss.

Position Management​

Do I have to enable position management?​

No. All four features (break-even, trailing, time-decay, TP ladder) are disabled by default. You can run an agent with none of them enabled and the trade's original SL and TP will simply run to completion.

Can I enable just one feature?​

Yes. Every feature is independently toggleable. Enable only break-even, only trailing, only time-decay, only TP ladder, or any combination.

Will trailing stop ever move my stop backwards?​

No. The ratchet guard ensures all SL changes must improve the floor. If a proposed trailing floor is worse than your current SL, the change is skipped.

What happens if ATR data is unavailable for ATR-based trailing?​

The trailing stop safely skips that cycle with a warning log. It resumes on the next cycle when ATR is available. Applying a trailing move without a valid volatility bound is dangerous, so the system chooses to wait.

How does time-decay interact with trailing stop?​

They're orthogonal. Trailing is price-driven (tracks the peak). Time-decay is time-driven (tightens on a fixed interval while ROE is below a stale threshold). Both share the same ratchet guard, so whichever one produces the most improved floor wins — neither can worsen the stop.

Can the TP ladder close my entire position?​

No. Total close percentage across all levels is enforced to stay under 100 at save time. You always keep at least some of the position running. This is a deliberate constraint — use a full manual close (or your base stop-loss) if you want to exit completely.

Saves And Concurrency​

What happens if I save while the agent was edited somewhere else?​

The server rejects your save with a 409 Conflict. The UI shows a "refresh and reapply" prompt. Your local draft is preserved until you acknowledge. This prevents silent overwrites when two tabs or devices edit the same agent.

Why do I see a dot next to some tabs?​

That's the unsaved-changes indicator. Strategy, Signals, Trades, and Position each track their own dirty state. If you make a change that differs from the last save, a dot appears beside that tab's label. Automation has no badge because it owns no persisted fields.

Does editing from the inline chat overlay use the same save contract?​

Yes. Inline overlay edits send the same revision-aware save as the full edit page, so concurrency protection applies equally to both paths.

Avatars​

How do agent avatars work?​

Two modes:

  1. Curated image — pick from the catalog of hand-crafted robot avatars hosted on Cloudflare.
  2. DiceBear fallback — if no curated image is selected, the agent uses a procedurally generated robot avatar seeded from the agent's seed value.

How do I change the avatar?​

On the edit page, click the avatar in the Identity Strip. The picker grid opens. Pick any catalog image, or hit the randomize button to clear back to a fresh DiceBear seed.

Can I upload my own avatar image?​

Not at this time. The avatar catalog is curated to ensure visual consistency across the platform. If you want a custom look, stick with DiceBear and regenerate seeds until you get one you like.

No. Agent avatars and player avatars are fully independent systems with separate catalogs, access rules, and lifecycles. Changing one never affects the other.

Troubleshooting​

My agent isn't producing signals. Why?​

Most common causes:

  • Trading mode is OFF — flip it to SIGNALS_ONLY or FULL_EXECUTION.
  • Balance threshold not met — your wallet balance is below the configured minimum.
  • Daily trade limit reached — check your max daily trades setting.
  • Score thresholds too high — try switching the signal preset to FRONTLINE or BLITZKRIEG to see more signals.
  • ATR floor too high — the current market may be below your configured volatility floor.

My trade didn't execute even though the signal was generated.​

Check:

  • Trading mode is SIGNALS_ONLY — you need to manually approve it.
  • Signal expired — the approval window passed before you acted.
  • Entry price drifted — the max entry deviation gate invalidated the setup.
  • Balance/exchange-minimum gate — your capital dropped below a threshold between signal and execution.

A position isn't getting managed even though I have break-even enabled.​

Verify:

  • Master toggle for position management is on.
  • Break-Even Protection is enabled.
  • Trigger ROE has actually been reached — the monitor runs every 10 seconds.
  • Position already hit break-even — it's a one-time event per trade, so re-firing doesn't happen.

More​

Still have questions? Check the other Agent docs: