인사이트 파이프

인사이트 파이프는 거래 아이디어를 단계별 의사결정 과정으로 구체화합니다. 포지션 수량 산정, 거래 시간대 제한, 손익비 검사, 진입 주문 제출, 포지션 관리에 사용하세요. 신호 생성은 알파 모델에서 처리하세요.

상태별 체인 구성하기

현재 엔진 상태는 New, Executed, Filled, Closed, Cancelled, Rejected입니다. 만료는 결과의 원인이며 별도의 Expired 상태가 아닙니다.

새 인사이트의 일반적인 체인은 진입 의도를 설정하고, 보호 수준을 정하고, 포지션 수량을 산정하고, 제약 조건을 검사한 다음 주문을 제출합니다. 체결된 인사이트에는 스톱, 익절, 분할 청산, 시간 기반 청산을 위한 관리 파이프를 사용하세요.

순서가 중요합니다. 위험 기준 수량 계산에는 관련 가격과 보호 설정 입력이 필요합니다. AQS에서 백테스트를 실행하기 전에 파이프라인 계층과 각 노드의 속성을 확인하세요.

사용자 지정 파이프 인터페이스

pub trait InsightPipe {
    fn version(&self) -> &str;
    fn run(
        &mut self,
        ctx: &mut dyn StrategyContext,
        insight: &mut Insight,
    ) -> InsightPipeResult;
}

위 코드는 핵심 인터페이스이며, 트레이트에는 선택적으로 구현할 수 있는 훅도 있습니다. InsightPipeResult는 단계의 통과 여부와 성공 여부, 선택적 메시지, 먼저 완료되어야 하는 의존성을 담습니다.

대기는 실패와 다릅니다

브로커 명령의 결과나 필수 스냅샷을 즉시 사용할 수 없는 경우가 있습니다. 런타임은 후속 처리를 보류한 상태로 유지하고, 필요한 의존성이 준비되면 재개합니다.

사용자 지정 단계에서 인사이트를 제출할 때는 제공된 헬퍼로 변경 결과를 변환하세요.

InsightPipeResult::from_mutation(insight.submit(ctx), self.name())

청산 단계에서는 다음을 사용하세요.

InsightPipeResult::from_exit_mutation(insight.close(ctx), self.name())

이는 파이프의 run 메서드 안에서 사용하는 반환 표현식입니다. 청산 헬퍼는 이후 단계가 같은 처리 차례에 또 다른 청산을 요청하지 못하도록 합니다. 스냅샷에 의존하는 로직은 InsightPipeResult::from_read_error를 사용해 아직 없는 계좌, 포지션, 호가 데이터에 대한 의존성을 유지할 수 있습니다.

변경 결과를 버리고 즉시 성공을 보고하지 마세요. 요청이 아직 대기열에 있거나 브로커 응답을 기다리는 중일 수 있습니다. 실행 요청 접수증은 주문 체결 확인이 아닙니다.

기본 제공 컴포넌트

컴포넌트	용도
`MarketOrderEntryPipe`	사용 가능한 봉 이력에서 시장가 진입 의도를 도출합니다.
`InsightTtlConfigPipe`	미체결 또는 체결된 인사이트가 활성 상태를 유지할 수 있는 기간을 구성합니다.
`MinimumRiskToRewardPipe`	제안된 위험과 보상을 검증합니다.
`InsightSubmitPipe`	대기 트리의 수용 한도를 검사하고 제출을 요청합니다.
`BasicStopLossPipe`	보호 조건이 발동되면 청산을 요청합니다.
`BasicTakeProfitPipe`	전체 또는 부분 익절 청산을 관리합니다.

기본 제공 청산 로직은 적용 가능한 실행 경로를 처리합니다. 새 실시간 전략에 과거의 봉 전용 손절 또는 익절 구현을 복사하기보다 이 컴포넌트를 사용하세요.

수량과 브로커 한도

현재 수량 산정 도구는 개별 주문의 최대 수량, 심볼별 합산 익스포저, 계좌의 대기 주문 한도를 구분합니다. 최대 수량을 초과하는 주문은 여러 주문으로 나누어 실행될 수 있습니다. 이렇게 나눈 주문은 논리적으로 별개의 DCA 단계가 아닙니다.

한도 계산에는 활성 상태 및 예약된 전략 수량이 포함됩니다. 다른 전략과 수동 주문도 브로커 한도를 사용할 수 있으므로 최종 기준은 브로커입니다. 브로커 및 데이터 피드를 참조하세요.

변경 사항 검증하기

백테스트를 실행한 뒤 체결된 인사이트뿐 아니라 거부 및 취소된 인사이트도 살펴보고, 각 단계가 중단된 이유를 상태 이력에서 확인하세요. 실거래 계좌에 적용하기 전에는 통제된 모의 거래 환경에서 동일한 구성을 검증하세요.