Update a Trading Agent

Update one or more fields on an existing trading agent. Only the fields you include in the request body are changed. This is useful for tuning risk parameters or renaming an agent without stopping it first.

Endpoint

PATCH /v1/agents/{agent_id}

Path parameters

string

required

Unique identifier of the agent to update.

Body parameters

All body fields are optional. Only provided fields are updated.

string

New human-readable name for the agent.

string

New wallet ID to bind trades to.

object

Risk configuration object. You can update individual nested fields using dot notation in some clients, or pass the full object:

position_size_pct (number)
stop_loss_pct (number)
trailing_stop_pct (number)
take_profit_pct (number)

float

New minimum signal confidence from 0.0 to 1.0.

integer

New maximum concurrent open positions.

Example request

curl -X PATCH "https://api.eluup.ai/v1/agents/agent_2vL9xQpW" \
  -H "Authorization: Bearer $ELUUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "risk": {
      "stop_loss_pct": 6.0,
      "take_profit_pct": 30.0
    },
    "min_confidence": 0.85
  }'

Response

Returns the updated agent object with the same fields as a full Get Agent response.

Example response

{
  "id": "agent_2vL9xQpW",
  "name": "Base Alpha Bot",
  "status": "active",
  "chain_id": 8453,
  "wallet_id": "wallet_1aB3cD5e",
  "risk": {
    "position_size_pct": 5.0,
    "stop_loss_pct": 6.0,
    "trailing_stop_pct": 10.0,
    "take_profit_pct": 30.0
  },
  "min_confidence": 0.85,
  "max_positions": 5,
  "stats": {
    "total_trades": 42,
    "win_rate_pct": 78.5,
    "total_pnl_usd": 1250.45
  },
  "created_at": 1715603200,
  "updated_at": 1716300000
}

Overview

Signals

Agents

Trades

Wallets

Account

Update a Trading Agent

Endpoint

Path parameters

Body parameters

Example request

Response

Example response

​Endpoint

​Path parameters

​Body parameters

​Example request

​Response

​Example response

Endpoint

Path parameters

Body parameters

Example request

Response

Example response