Skip to main content
You can update an agent’s behavior at any time by calling PATCH /agents/. The most important configuration is the risk object, which controls how large each position is and how the agent protects downside. You can also tune the signal filter and the maximum number of concurrent positions.

Configurable Fields

string
Display name for the agent. This does not affect trading behavior.
number
default:"0.05"
Fraction of available wallet balance to allocate per trade. Valid range: 0.01 to 0.25.
Example: 0.05 means each trade uses 5% of the wallet’s available balance.
number
default:"0.07"
Maximum loss, expressed as a fraction of entry price, before the position is closed. Valid range: 0.02 to 0.20.
Example: 0.07 closes the position if the price drops 7% below entry.
number
default:"0.04"
Distance below the highest price reached during the trade before a trailing-stop exit fires. Valid range: 0.01 to 0.15.
Example: if the token rises 30% and then falls 4% from its peak, the trailing stop closes the position.
number
default:"0.20"
Profit target at which the position is closed automatically. Valid range: 0.05 to 1.00.
Example: 0.20 takes profit when the price rises 20% above entry.
number
default:"0.70"
Minimum signal confidence required for the agent to act. Valid range: 0.50 to 1.00.
Higher values reduce trade frequency and focus the agent on the highest-probability setups.
integer
default:"3"
Maximum number of open positions the agent will hold at once. Valid range: 1 to 10.
Once this limit is reached, the agent will skip new signals until an existing position closes.

Example: Update an Agent

The following request changes the agent’s position size and tightens the stop loss:

Example Response

Changing risk parameters on an active agent affects future trades immediately, but does not retroactively adjust open positions. If you want existing positions to follow new stop or take-profit levels, close them first or pause the agent and restart after the update.
You can tune the agent to match your risk tolerance. Here are three common profiles: