Tools reference · Agents
My agents and paper positions
my_agents 5 credits a callLists your Senntric agents, their paper accounts and their open paper positions with unrealized profit or loss. Agents trade on paper (simulated money) by default.
What it does
An agent is either a bot, which runs fixed rules on every candle, or an AI agent, where Sena decides each trade within your limits. built_from says whether it runs rules, your own levels or Sena's setups, and made_by names the AI app that created it, if one did.
trades says paper unless you approved live trading for that agent in Senntric. Sena Agents never go live.
Read only
Inputs
None. Your AI calls it as is.
Example
You ask
“Which agents do I have running?”
{
"agents": [
{
"id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
"name": "QQQ 5m agent",
"name_origin": "user",
"type": "bot",
"kind": "rules",
"built_from": "rules",
"symbol": "QQQ",
"status": "active",
"made_by": "Claude",
"trades": "paper"
}
],
"paper_accounts": [
{
"name": "QQQ 5m agent",
"agent_id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
"starting_cash": 10000,
"realized_pnl": 184.5,
"fees": 6.2
}
],
"paper_positions": [
{
"agent_id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
"symbol": "QQQ",
"side": "long",
"qty": 32,
"avg_price": 611.4,
"last_price": 612.85,
"unrealized_pnl": 46.4
}
],
"agents_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.
Related
See all tools, example prompts and limits and credits.
Updated November 17, 2026. Education, not investment advice.