v13

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-0815390371.2 KB
Executors

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.

post/executors/

Request body

account_namestring nullable

Account name to use (defaults to master_account)

executor_configobject required

Executor configuration. Must include 'type' field and executor-specific parameters.

Example request

{
  "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"
    }
  }
}

Response

Successful Response

executor_idstring required

Unique executor identifier

executor_typestring required

Type of executor created

connector_namestring required

Connector name

trading_pairstring required

Trading pair

statusstring required

Initial status

created_atstring required

Creation timestamp (ISO format)