Tools reference · Agents
Pause an agent
Action
stop_agent 5 credits a callPauses 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
| Name | Description |
|---|---|
agent_id Required | id. The agent's id, as my_agents lists it. Your AI looks it up for you. |
close_position Optional | true 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.”
{
"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.
Related
See all tools, example prompts and limits and credits.
Updated November 17, 2026. Education, not investment advice.