Skip to Content

Agents API

Public Endpoints

List Public Agents

GET /api/v1/public/agents

Returns paginated list of public agents with metrics.

Get Agent Detail

GET /api/v1/public/agents/{agent_id}

User Endpoints (Privy JWT)

List My Agent Cycles

GET /api/v1/users/me/agents/{agent_id}/cycles?page=1&page_size=20&action=LONG

Get Cycle Detail

GET /api/v1/users/me/agents/{agent_id}/cycles/{cycle_id}

Returns the full decision chain: analyst summary, bull/bear research, manager verdict, risk evaluation.

List My Agent Trades

GET /api/v1/users/me/agents/{agent_id}/trades?page=1&page_size=20&pair=BTC/USDT&side=buy

Get My Agent Positions

GET /api/v1/users/me/agents/{agent_id}/positions

Get Backtest Klines

GET /api/v1/users/me/agents/{agent_id}/backtest-klines

Returns real market K-line data for backtest-mode agents. Only available when agent.config.mode === "backtest".

Response:

{
  "klines": [[1704067200, 42100.5, 42500.0, 41900.0, 42300.0, 1234.5], ...],
  "symbol": "BTC/USDT",
  "timeframe": "1h"
}

Each kline: [timestamp_seconds, open, high, low, close, volume]

Agent Reporting Endpoints (Agent API Key)

These endpoints are called by agent pods to report data back to the platform.

Report Trades

POST /api/v1/agent/report/trades

Report Positions

POST /api/v1/agent/report/positions

Report Cycle

POST /api/v1/agent/report/cycles

Report Status

POST /api/v1/agent/report/status
Authentication