List AI Trading Agents

Retrieve a list of your trading agents. Use this endpoint to monitor which agents are active and filter by run status when building dashboards or management tools.

Endpoint

GET /v1/agents

Query parameters

string

Filter by agent status. Supported values: active, idle, paused, error.

integer

default:"20"

Number of agents per page. Maximum is 100.

string

Opaque cursor from a previous response to fetch the next page.

Example request

curl -H "Authorization: Bearer $ELUUP_API_KEY" \
  "https://api.eluup.ai/v1/agents?status=active&limit=10"

Response

array

Array of agent summary objects.

string

Unique agent identifier.

string

Human-readable agent name.

string

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

integer

Chain the agent trades on.

string

ID of the connected wallet.

integer

Unix timestamp when the agent was created.

string

Cursor for the next page, omitted when there are no more results.

Example response

{
  "data": [
    {
      "id": "agent_2vL9xQpW",
      "name": "Base Alpha Bot",
      "status": "active",
      "chain_id": 8453,
      "wallet_id": "wallet_1aB3cD5e",
      "created_at": 1715603200
    },
    {
      "id": "agent_8kM4nR0t",
      "name": "BNB Momentum Scalper",
      "status": "idle",
      "chain_id": 56,
      "wallet_id": "wallet_7gH9iJ2k",
      "created_at": 1715500000
    }
  ],
  "next_cursor": "eyJpZCI6ImFnZW50XzhrTTRuUjB0IiwidHMiOjE3MTU1MDAwMDB9"
}

Overview

Signals

Agents

Trades

Wallets

Account

List AI Trading Agents

Endpoint

Query parameters

Example request

Response

Example response

​Endpoint

​Query parameters

​Example request

​Response

​Example response

Endpoint

Query parameters

Example request

Response

Example response