Get a Trading Agent

Retrieve detailed information about a specific trading agent, including its current status, risk configuration, and aggregate performance stats such as total trades and win rate.

Endpoint

GET /v1/agents/{agent_id}

Path parameters

string

required

Unique identifier of the agent.

Example request

curl -H "Authorization: Bearer $ELUUP_API_KEY" \
  "https://api.eluup.ai/v1/agents/agent_2vL9xQpW"

Response

string

Unique agent identifier.

string

Agent name.

string

Current status: active, idle, paused, or error.

integer

Chain the agent trades on.

string

Connected wallet ID.

object

Risk configuration with position_size_pct, stop_loss_pct, trailing_stop_pct, take_profit_pct.

float

Minimum signal confidence threshold.

integer

Maximum concurrent open positions.

object

total_trades (integer): Number of completed trades.
win_rate_pct (float): Percentage of winning trades.
total_pnl_usd (float): Total realized profit and loss in USD.

integer

Unix timestamp of creation.

integer

Unix timestamp of the last configuration change.

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": 8.0,
    "trailing_stop_pct": 10.0,
    "take_profit_pct": 25.0
  },
  "min_confidence": 0.80,
  "max_positions": 5,
  "stats": {
    "total_trades": 42,
    "win_rate_pct": 78.5,
    "total_pnl_usd": 1250.45
  },
  "created_at": 1715603200,
  "updated_at": 1716200000
}

Overview

Signals

Agents

Trades

Wallets

Account

Get a Trading Agent

Endpoint

Path parameters

Example request

Response

Example response

​Endpoint

​Path parameters

​Example request

​Response

​Example response

Endpoint

Path parameters

Example request

Response

Example response