Skip to main content

Ask your agent for a trade

How to request a trade evaluation from your agent. Agents evaluate trades on their own schedule via Radar, but you can also ask them directly.

← Trade overview · Radar overview


Quick start​

  1. Open Commander or use the MCP tools
  2. Ask your agent to evaluate a coin (e.g., "Should I go long ETH?")
  3. The agent evaluates using its strategy at the next candle close
  4. Approve or Decline the result

How it works​

When you ask an agent for a trade:

You ask → Agent evaluates → Decision ready → You approve or decline
  1. Request — You ask the agent to look at a trade
  2. Evaluate — The agent runs its strategy at the next candle close
  3. Decide — The agent returns Traded, No trade, Claimed, or Missed
  4. Act — You approve or decline the result

Where to ask​

SurfaceHow it works
CommanderChat with your agent: "Look at BTC" or "Should I go long ETH?"
MCPUse propose_entry_decision via API or third-party integrations

The Trade screen itself is for manual orders only. To ask an agent, use Commander or MCP.


What the agent returns​

The agent evaluates using its strategy and returns one of these results:

ResultWhat it means
TradedThe agent found a valid setup and opened a trade
No tradeConditions didn't match — no entry
ClaimedAnother agent on the same team already holds a position on this coin
MissedA valid signal existed but the entry window passed

These are the same result labels used in Radar. See One trade per team per coin for how agents share coins.


Approving a trade​

When the agent finds a valid setup, you can:

ActionWhat happens
ApproveThe trade executes using the strategy's entry policy
DeclineThe opportunity is dismissed — no order placed

If you don't respond before the entry window closes, the decision expires.


Good to know​

  • One request per team per coin — You can't request a second evaluation on the same coin for the same team until the first clears
  • Candle close timing — The agent evaluates at the next candle close on its timeframe, not immediately
  • Same strategy, same rules — The agent uses the same strategy it uses for Radar — no special evaluation
  • Position conflicts — If the agent's team already has an open position on that coin, the agent can't open another

Advanced: how this relates to Radar

Asking an agent for a trade and Radar both use the same evaluation path:

SurfaceWho initiatesWhen it evaluates
Commander/MCPYou askNext candle close after your request
RadarAutomaticEvery candle close while deployed

The strategy, risk rails, and execution are identical. The only difference is who starts the evaluation.

Advanced: request lifecycle

A trade request moves through these states:

  1. Pending — Waiting for the next candle close
  2. Evaluating — Agent is running the strategy
  3. Ready — Decision available for approval
  4. Completed — You approved, declined, or it expired

You can cancel a pending request before evaluation starts.


← Trade overview · Radar overview