> ## Documentation Index
> Fetch the complete documentation index at: https://condor.hummingbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Executor

> 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.



## OpenAPI

````yaml /api-reference/openapi.json post /executors/
openapi: 3.1.0
info:
  title: Hummingbot API
  description: API for managing Hummingbot trading instances
  version: 1.0.1
servers:
  - url: http://localhost:8000
    description: Local development server
security: []
paths:
  /executors/:
    post:
      tags:
        - Executors
      summary: Create Executor
      description: >-
        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.
      operationId: create_executor_executors__post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExecutorRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateExecutorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBasic: []
components:
  schemas:
    CreateExecutorRequest:
      properties:
        account_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Name
          description: Account name to use (defaults to master_account)
        executor_config:
          additionalProperties: true
          type: object
          title: Executor Config
          description: >-
            Executor configuration. Must include 'type' field and
            executor-specific parameters.
      type: object
      required:
        - executor_config
      title: CreateExecutorRequest
      description: Request to create a new executor.
      examples:
        - description: Create a position executor with triple barrier
          summary: Position Executor
          value:
            account_name: master_account
            executor_config:
              amount: '0.01'
              connector_name: binance_perpetual
              leverage: 10
              side: BUY
              trading_pair: BTC-USDT
              triple_barrier_config:
                stop_loss: '0.02'
                take_profit: '0.04'
                time_limit: 3600
              type: position_executor
        - description: Create an LP position on a CLMM DEX
          summary: LP Executor
          value:
            account_name: master_account
            executor_config:
              base_amount: '0'
              connector_name: solana-mainnet-beta
              extra_params:
                strategyType: 0
              keep_position: false
              lower_price: '80'
              lp_provider: meteora/clmm
              pool_address: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
              quote_amount: '10.0'
              side: 1
              type: lp_executor
              upper_price: '100'
    CreateExecutorResponse:
      properties:
        executor_id:
          type: string
          title: Executor Id
          description: Unique executor identifier
        executor_type:
          type: string
          title: Executor Type
          description: Type of executor created
        connector_name:
          type: string
          title: Connector Name
          description: Connector name
        trading_pair:
          type: string
          title: Trading Pair
          description: Trading pair
        status:
          type: string
          title: Status
          description: Initial status
        created_at:
          type: string
          title: Created At
          description: Creation timestamp (ISO format)
      type: object
      required:
        - executor_id
        - executor_type
        - connector_name
        - trading_pair
        - status
        - created_at
      title: CreateExecutorResponse
      description: Response after creating an executor.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBasic:
      type: http
      scheme: basic

````