---
title: "Create Executor"
method: POST
path: "/executors/"
tags: ["Executors"]
---

# Create Executor

`POST /executors/`

Create and start a new executor.

Supported executor types:
- **position_executor**: Single position with triple barrier (stop loss, take profit, time limit)
- **grid_executor**: Grid trading with multiple levels
- **dca_executor**: Dollar-cost averaging with multiple entry points
- **twap_executor**: Time-weighted average price execution
- **arbitrage_executor**: Cross-exchange arbitrage
- **xemm_executor**: Cross-exchange market making
- **order_executor**: Simple order execution
- **lp_executor**: Liquidity provider position on CLMM DEXs (Meteora, Raydium, etc.)

The `executor_config` must include:
- `type`: One of the executor types above
- `connector_name`: Exchange connector (e.g., "binance", "binance_perpetual")
- `trading_pair`: Trading pair (e.g., "BTC-USDT")
- Additional type-specific configuration (see /executors/types/{type}/config for details)

Returns the created executor ID and initial status.

## Request body

- CreateExecutorRequest — Request to create a new executor.
  - `account_name` string, nullable — Account name to use (defaults to master_account)
  - `executor_config` object, required — Executor configuration. Must include 'type' field and executor-specific parameters.

## Response `201`

Successful Response

- CreateExecutorResponse — Response after creating an executor.
  - `executor_id` string, required — Unique executor identifier
  - `executor_type` string, required — Type of executor created
  - `connector_name` string, required — Connector name
  - `trading_pair` string, required — Trading pair
  - `status` string, required — Initial status
  - `created_at` string, required — Creation timestamp (ISO format)

## Other responses

- `422` — Validation Error

---

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