---
title: "Stop Executor"
method: POST
path: "/executors/{executor_id}/stop"
tags: ["Executors"]
---

# Stop Executor

`POST /executors/{executor_id}/stop`

Stop an active executor.

Options:
- `keep_position`: If true, keeps any open position (for position executors).
  If false, the executor will attempt to close all positions before stopping.

Returns confirmation of the stop action.

## Path parameters

- `executor_id` string, required

## Request body

- StopExecutorRequest — Request to stop an executor.
  - `keep_position` boolean — Whether to keep the position open (for position executors)

## Response `200`

Successful Response

- StopExecutorResponse — Response after stopping an executor.
  - `executor_id` string, required — Executor identifier
  - `status` string, required — New status (usually 'stopping')
  - `keep_position` boolean, required — Whether position was kept open

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-08** `92703f48a69e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/executors/:executor_id/stop/post.md)

---

[API](https://skmtc.dev/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.dev/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)