Skip to main content
GET
/
executors
/
{executor_id}
Get Executor
curl --request GET \
  --url http://localhost:8000/executors/{executor_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "account_name": "master_account",
  "connector_name": "binance_perpetual",
  "created_at": "2024-01-15T10:30:00Z",
  "cum_fees_quote": 1.25,
  "executor_id": "abc123...",
  "executor_type": "position_executor",
  "filled_amount_quote": 5000,
  "is_active": true,
  "is_trading": true,
  "net_pnl_pct": 2.5,
  "net_pnl_quote": 125.5,
  "side": "BUY",
  "status": "RUNNING",
  "timestamp": 1705315800,
  "trading_pair": "BTC-USDT"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
executor_id
string
required

Response

Successful Response

Detailed response for a single executor.

​
executor_id
string
required

Unique executor identifier

​
executor_type
string | null
required

Type of executor

​
account_name
string | null
required

Account name

​
connector_name
string | null
required

Connector name

​
trading_pair
string | null
required

Trading pair

​
status
string
required

Current status (RUNNING, TERMINATED, etc.)

​
is_active
boolean
required

Whether the executor is active

​
is_trading
boolean
required

Whether the executor has open trades

​
net_pnl_quote
number
required

Net PnL in quote currency

​
net_pnl_pct
number
required

Net PnL percentage

​
cum_fees_quote
number
required

Cumulative fees in quote currency

​
filled_amount_quote
number
required

Total filled amount in quote currency

​
side
string | null

Trade side (BUY/SELL) if applicable

​
timestamp
number | null

Creation timestamp (Unix)

​
created_at
string | null

Creation timestamp (ISO format)

​
close_type
string | null

How the executor was closed (if applicable)

​
close_timestamp
number | null

Close timestamp (Unix)

​
controller_id
string | null

ID of the controller that spawned this executor

​
error_count
integer
default:0

Number of ERROR-level log entries captured

​
last_error
string | null

Most recent error message, if any

​
config
Config · object

Full executor configuration

​
custom_info
Custom Info · object

Executor-specific custom information