Create Executor

curl --request POST \
  --url http://localhost:8000/executors/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "executor_config": {},
  "account_name": "<string>"
}
'

{
  "executor_id": "<string>",
  "executor_type": "<string>",
  "connector_name": "<string>",
  "trading_pair": "<string>",
  "status": "<string>",
  "created_at": "<string>"
}

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//config for details)

Returns the created executor ID and initial status.

POST

executors

Create Executor

curl --request POST \
  --url http://localhost:8000/executors/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "executor_config": {},
  "account_name": "<string>"
}
'

{
  "executor_id": "<string>",
  "executor_type": "<string>",
  "connector_name": "<string>",
  "trading_pair": "<string>",
  "status": "<string>",
  "created_at": "<string>"
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Request to create a new executor.

executor_config

Executor Config · object

required

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

account_name

string | null

Account name to use (defaults to master_account)

Response

Successful Response

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)

Restart Order Book Tracker List Executors

Documentation Index

Authorizations

Body

Response