Tools reference · Agents

Agent results

Read agent_results 10 credits a call

Shows how your agents are doing on paper: profit and loss, equity, open positions, each closed trade, and Sena's review of a trade once one is written.

What it does

With an agent_id it shows that agent's last 20 closed trades, or up to 50. Without one it covers all your agents, 5 trades each. pnl is after fees, and r_on_planned_risk is a trade's result over the agent's risk per trade.

live says whether the agent is on paper only, waiting for your approval to go live, or live through your own TradersPost account.

Read only

This tool reads data. It changes nothing in your account.

Inputs

agent_id Optionalid. One agent's id, as my_agents lists it. Leave it out for all your agents.
limit Optionalwhole number, 1 to 50. How many closed trades to show, newest first, from 1 to 50. The default is 20.

Example

You ask

“How is my QQQ agent doing on paper?”

Result (trimmed, example values)
{
  "agents": [
    {
      "agent": {
        "id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
        "name": "QQQ 5m agent",
        "status": "running",
        "trades": "paper",
        "risk_per_trade_usd": 100
      },
      "results": {
        "starting_cash": 10000,
        "realized_pnl": 184.5,
        "unrealized_pnl": 46.4,
        "equity": 10230.9,
        "closed_trades_shown": 5,
        "wins_shown": 3
      },
      "trades": [
        {
          "symbol": "QQQ",
          "side": "long",
          "qty": 54,
          "entry": 609.42,
          "exit": 613.1,
          "pnl": 197.6,
          "r_on_planned_risk": 1.98,
          "sena_review": null
        }
      ],
      "live": {
        "status": "paper"
      }
    }
  ],
  "available": true
}

Your AI reads this result and answers in plain words. Most results include an open_in_senntric link to see the same thing in Senntric.

See all tools, example prompts and limits and credits.

Updated November 17, 2026. Education, not investment advice.