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

# Get Executor

> Get detailed information about a specific executor.

Checks active executors in memory first, then falls back to database for completed executors.

Returns full executor information including:
- Current status and PnL
- Full configuration
- Executor-specific custom information



## OpenAPI

````yaml /api-reference/openapi.json get /executors/{executor_id}
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/{executor_id}:
    get:
      tags:
        - Executors
      summary: Get Executor
      description: >-
        Get detailed information about a specific executor.


        Checks active executors in memory first, then falls back to database for
        completed executors.


        Returns full executor information including:

        - Current status and PnL

        - Full configuration

        - Executor-specific custom information
      operationId: get_executor_executors__executor_id__get
      parameters:
        - name: executor_id
          in: path
          required: true
          schema:
            type: string
            title: Executor Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutorDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBasic: []
components:
  schemas:
    ExecutorDetailResponse:
      properties:
        executor_id:
          type: string
          title: Executor Id
          description: Unique executor identifier
        executor_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Executor Type
          description: Type of executor
        account_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Name
          description: Account name
        connector_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Connector Name
          description: Connector name
        trading_pair:
          anyOf:
            - type: string
            - type: 'null'
          title: Trading Pair
          description: Trading pair
        side:
          anyOf:
            - type: string
            - type: 'null'
          title: Side
          description: Trade side (BUY/SELL) if applicable
        status:
          type: string
          title: Status
          description: Current status (RUNNING, TERMINATED, etc.)
        is_active:
          type: boolean
          title: Is Active
          description: Whether the executor is active
        is_trading:
          type: boolean
          title: Is Trading
          description: Whether the executor has open trades
        timestamp:
          anyOf:
            - type: number
            - type: 'null'
          title: Timestamp
          description: Creation timestamp (Unix)
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: Creation timestamp (ISO format)
        close_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Close Type
          description: How the executor was closed (if applicable)
        close_timestamp:
          anyOf:
            - type: number
            - type: 'null'
          title: Close Timestamp
          description: Close timestamp (Unix)
        controller_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Controller Id
          description: ID of the controller that spawned this executor
        net_pnl_quote:
          type: number
          title: Net Pnl Quote
          description: Net PnL in quote currency
        net_pnl_pct:
          type: number
          title: Net Pnl Pct
          description: Net PnL percentage
        cum_fees_quote:
          type: number
          title: Cum Fees Quote
          description: Cumulative fees in quote currency
        filled_amount_quote:
          type: number
          title: Filled Amount Quote
          description: >-
            Volume traded, in quote currency. For an executor that places orders
            the amount it filled IS its volume. An LP executor reports the same
            thing rather than the capital it deposited — depositing trades
            nothing — deriving it from the fees it earned, which are a fixed
            fraction of the swaps that crossed its range, and is 0 while it has
            earned none.
        error_count:
          type: integer
          title: Error Count
          description: Number of ERROR-level log entries captured
          default: 0
        last_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Error
          description: Most recent error message, if any
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Config
          description: Full executor configuration
        custom_info:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Custom Info
          description: Executor-specific custom information
      type: object
      required:
        - executor_id
        - executor_type
        - account_name
        - connector_name
        - trading_pair
        - status
        - is_active
        - is_trading
        - net_pnl_quote
        - net_pnl_pct
        - cum_fees_quote
        - filled_amount_quote
      title: ExecutorDetailResponse
      description: Detailed response for a single executor.
      example:
        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
    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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.