> ## 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: Total filled amount in quote currency
        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

````