Skip to main content
Once an agent is active, you can monitor its current state, review every trade it has executed, and inspect open positions at any time. This page covers the three primary monitoring endpoints and the performance metrics returned by the agent status resource.

Agent Status

Call GET /agents/ to retrieve the full agent object, including its current state and high-level performance numbers.
The response includes summary metrics updated as trades settle:
integer
Total number of completed trades since the agent was created.
number
Fraction of trades that closed at a profit. Range: 0.00 to 1.00.
number
Cumulative realized profit and loss across all completed trades, in USD.
number
Total return on investment, expressed as a fraction of cumulative capital deployed.
number
Average duration from entry to exit across all completed trades, in minutes.
Example metrics in an agent response:

Trade History

To inspect every trade the agent has made, query GET /trades with the agent_id filter:
Each trade record includes the token, entry and exit prices, PnL, and the trigger that caused the exit (stop loss, take profit, trailing stop, or signal).

Open Positions

Get a snapshot of positions that are still live by filtering GET /positions with agent_id:
The response includes the current unrealized PnL for each position, the entry price, and the active risk levels (stop loss, trailing stop, take profit) so you can see exactly where each trade stands.

Sample Trade Record

Close a Position Manually

If you need to exit a position before the agent’s risk controls trigger, call POST /positions//close:
Every trade executed by an ELUUP AI agent is recorded on chain. You can verify agent activity and inspect trade receipts using the on-chain Proof of Trades feature on eluup.ai.