Tools reference · Agents

Pause an agent

Action stop_agent 5 credits a call

Pauses an agent so it takes no new trades. An open trade keeps its stop and target unless you ask to close it at market.

What it does

This works on agents that trade live too. To resume a live agent, use Senntric.

This tool makes a change

It changes something in your Senntric account. It needs the “Make changes” permission when you connect, and your AI app asks you to confirm before it runs. It can’t place an order at your broker.

Inputs

agent_id Requiredid. The agent's id, as my_agents lists it. Your AI looks it up for you.
close_position Optionaltrue or false. True to also close its open trade at market. The default is false, which leaves the trade to its stop and target.

Example

You ask

“Pause my QQQ agent.”

Result (trimmed, example values)
{
  "stopped": true,
  "agent": {
    "id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
    "name": "QQQ 5m agent",
    "symbol": "QQQ",
    "status": "paused",
    "version": 2,
    "trades": "paper"
  },
  "note": "Paused: no new entries. An open trade keeps its stop and target (pass close_position to close it)."
}

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.