List Trades

Retrieve completed trades across all your agents or filter to a single agent. Use this endpoint to review historical performance, export records, or audit PnL and ROI across positions.

Endpoint

GET /v1/trades

Query parameters

string

Filter trades to a specific agent.

string

Filter by trade status. Supported values: open, closed.

integer

default:"20"

Number of trades 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/trades?agent_id=agent_2vL9xQpW&status=closed&limit=10"

Response

array

Array of trade objects.

string

Unique trade identifier.

string

ID of the agent that executed the trade.

string

Contract address of the traded token.

string

Token symbol.

integer

Chain the trade occurred on.

string

Either BUY or SELL.

float

Entry price in USD.

float

Exit price in USD. Null if the trade is still open.

float

Realized profit or loss in USD. Null if the trade is open.

float

Return on investment percentage. Null if the trade is open.

string

open or closed.

integer

Unix timestamp when the trade was opened.

integer

Unix timestamp when the trade was closed. Null if still open.

string

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

Example response

{
  "data": [
    {
      "id": "trade_9aBc2DeF8Gh",
      "agent_id": "agent_2vL9xQpW",
      "token_address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
      "token_symbol": "BRETT",
      "chain_id": 8453,
      "direction": "BUY",
      "entry_price_usd": 0.0342,
      "exit_price_usd": 0.0427,
      "pnl_usd": 85.50,
      "roi_pct": 24.85,
      "status": "closed",
      "opened_at": 1715603200,
      "closed_at": 1715700000
    }
  ],
  "next_cursor": "eyJpZCI6InRyYWRlXzJ4WXozVnFRNksiLCJ0cyI6MTcxNTcwMDAwMH0"
}

Overview

Signals

Agents

Trades

Wallets

Account

Endpoint

Query parameters

Example request

Response

Example response

​Endpoint

​Query parameters

​Example request

​Response

​Example response

Endpoint

Query parameters

Example request

Response

Example response