본문으로 건너뛰기
Pit Officer
자체 호스팅 사전 거래 리스크 통제

주문을 검증하고 다음 단계를 통제하십시오.

내장 브로커 및 거래소 연결, 시장 가격 자동 수신, 사전 거래 리스크 검증을 제공합니다. 로컬 패널, REST API 또는 MCP 도구로 계좌와 주문 흐름을 운영하십시오.

Officer 사용해 보기 문서 읽기
브로커 및 가격 피드 보기

오픈 소스 · Apache-2.0

내장 거래 연결
Interactive Brokers · Binance · Alpaca · eToro
직접 활성화한 연결로 승인된 주문을 전송하고 체결 정보를 수신합니다.
시장 가격 자동 수신
상품을 구독하십시오. Officer가 연결된 소스에서 가격을 받아 리스크 엔진에 제공합니다.
워크플로 보기

연결

브로커에 연결하고 가격을 자동으로 수신하십시오.

패널에서 필요한 연결을 선택하십시오. 거래 연결은 주문을 전송하고, 시장 데이터 피드는 리스크 점검에 시장 가격을 제공합니다.

내장 거래 연결

  • Interactive Brokers
  • Binance
  • Alpaca
  • eToro

직접 활성화한 연결로 승인된 주문을 전송하고 체결 상태 업데이트를 수신하십시오.

본인의 브로커 계정과 인증 정보를 사용하십시오. 사용 가능한 상품과 테스트 또는 실제 거래 모드는 제공업체 및 연결 설정에 따라 다릅니다.

시장 데이터 피드

  • Interactive Brokers
  • Binance
  • Kraken
  • Coinbase
  • Alpaca
  • OKX
  • Bybit
  • OANDA
  • Finnhub

소스를 선택하고 상품을 구독하십시오. Officer가 리스크 점검을 위한 가격을 자동으로 수신합니다. 자체 피드도 연결할 수 있습니다.

제공업체 인증 정보, 시장 데이터 권한 및 구독에 따라 사용할 수 있는 가격이 결정됩니다. 가격 피드만으로는 거래가 활성화되지 않습니다.

Officer 시작 및 연결 설정

사용 사례

필요한 업무부터 시작하십시오.

주문 흐름을 구축하고, 리스크를 운영하며, 거래 자동화를 개발하는 분들을 위한 도구입니다. 각 경로는 직접 관리하는 통제 수단과 필요한 통합에서 시작합니다.

  • 자기매매 데스크 · 리스크 팀

    전략 외부에서 계좌 한도를 관리하십시오

    하나의 패널에서 계좌, 그룹 및 리스크 정책을 운영하십시오. 전략 코드를 변경하지 않고 계좌나 그룹을 차단하여 새로운 리스크 승인을 중지할 수 있습니다.

    • 동일한 제어 영역에서 포지션, 정책 판단 및 계좌 변경을 검토하십시오.
    • 차단은 리스크 통제 관문입니다. 전체 주문 취소, 포지션 청산 또는 이미 체결된 거래의 원상 복구를 의미하지 않습니다.
    문서 읽기
  • 브로커 · 거래소 엔지니어

    주문 흐름에 리스크 판단을 추가하십시오

    REST로 주문을 평가하고 체결을 보고하십시오. 승인 전용 통합에서는 실행 구성 요소가 주문을 보내기 전에 해당 주문의 정확한 내용에 연결된 서명된 승인 판단을 검증해야 합니다.

    • 체결 보고로 체결 내역과 계좌 상태를 최신으로 유지하십시오. 거래 후 보고만으로는 거래를 방지할 수 없습니다.
    • 내장 거래 연결을 사용하거나 기존 실행 시스템을 유지하면서 리스크 API를 통합하십시오.
    문서 읽기
  • 에이전트 구축자 · 개발자

    에이전트에 필요한 도구만 제공하십시오

    MCP로 연결하며 기본적으로 읽기 전용 도구가 활성화됩니다. 운영자가 상태 변경 도구의 활성화 여부를 선택합니다. 부여한 권한도 리스크 경계의 일부입니다.

    • 계좌 차단과 차단 해제는 MCP 도구에 포함되지 않습니다.
    • 검증과 전송은 별도 작업입니다. 활성화된 연결로 거래하려면 거래 경로를 사용해야 합니다. 자체 브로커 자격 증명이 있는 독립 에이전트는 외부 관문을 우회할 수 있습니다.
    문서 읽기
  • 퀀트 팀 · 독립 트레이더와 개발자

    명시적인 리스크 규칙에 따라 전략을 평가하십시오

    패널에서 가격 소스를 연결하고 상품을 구독하십시오. Officer가 시장 가격을 자동 수신합니다. 리스크 정책을 구성하고 후보 주문의 판단을 검토한 뒤 실행이 필요할 때 내장 거래 연결을 추가하십시오.

    • OpenPit는 보고된 체결에서 실현 손익을 계산하고 설정된 외환 데이터로 계좌 통화로 환산합니다.
    • 손익 배리어는 엔진에 제공된 상태와 데이터에 따라 작동합니다. 이는 통제 수단이며 거래 손실을 막아 준다는 보장이 아닙니다.
    문서 읽기

작동 방식

하나의 엔진, 세 가지 사용 방식입니다.

패널, REST 및 MCP는 Officer의 제어 영역을 공유합니다. 주문 평가, 체결 및 보고는 별개의 작업입니다.

  1. 01 평가

    OpenPit 엔진

    설정된 정책, 계좌 상태 및 필요한 시장 데이터에 따라 주문을 평가하고 사유와 함께 승인 또는 거절을 반환합니다.

    결정성이란 포지션, 예약 및 시장 데이터를 포함한 모든 입력과 상태가 같아야 한다는 뜻입니다.

  2. 02 조정

    Pit Officer 컨트롤 플레인

    로컬 데이터베이스에 계좌, 그룹, 정책, 주문 및 감사 기록을 저장합니다. 시작 시 엔진 상태를 복원합니다.

    내장 거래 연결은 승인된 주문을 전송하고 체결 정보를 Officer로 가져옵니다. 시장 데이터 구독은 엔진에 가격을 자동으로 제공합니다.

  3. 03 운영

    오퍼레이터 패널

    계좌, 포지션 및 주문을 검토하고, 정책과 MCP 권한을 관리하고, 데이터 소스를 구성하고 감사 이력을 확인하십시오.

    REST나 MCP에서도 동일한 제어 영역을 사용합니다. 엔드포인트 접근과 활성화한 도구는 배포 경계의 일부입니다.

주문 요청에서 리스크 판단까지

승인 전용 통합은 실행 시스템에 판단을 반환합니다. 서명을 활성화한 경우, 실행 전에 서명된 승인 판단과 정확한 주문 매개변수를 검증하십시오. 전송에는 활성화된 연결을 사용하여 선택한 거래 장소에 전송합니다. Officer는 설정된 거래 및 시장 데이터 대상에 데이터를 전송합니다.

시장 데이터 및 거래 연결

시장 데이터 피드
시장 가격
동일한 Pit Officer
승인된 주문
체결 정보 업데이트
브로커 / 거래소

패널 들여다보기

통제 수단을 한곳에서 관리하십시오.

로컬 패널에서 API가 제공하는 동일한 상태를 검토하고 조작하십시오. 다음 질문에 답하는 페이지부터 시작하십시오.

대시보드
엔티티 개수, 에이전트에게 허용된 명령 표면, 마켓 데이터 상태, 그리고 감사 로그에서 가져온 최근 활동.
정책
계좌와 자산별로 엔진에 적용되는 리스크 정책 장벽. 각 행은 주문 흐름에 대한 하나의 제약입니다.
계좌
계좌와 그룹을 한곳에서 관리하십시오. 계좌나 그룹을 차단하여 새로운 리스크 승인을 막고, 적절한 시점에 차단을 해제하십시오.
주문
자신의 외부 주문 ID에 대한 체결을 보고하고, 사람의 확인을 기다리는 주문을 확정하거나 취소할 수 있습니다.
감사
기록된 작업과 출처를 확인하십시오. 감사 API는 개별 기록을 수정하지 않습니다. 백업 복원과 데이터 초기화는 별도의 작업입니다.
MCP 접근
AI 에이전트가 호출할 수 있는 명령을 선택한 뒤, MCP로 연결합니다. 보호된 명령에는 명시적인 옵트인이 필요합니다.
서명 키
승인 서명을 구성하십시오. 외부 실행 시스템은 주문을 보내기 전에 서명된 승인 판단과 연결된 주문 매개변수를 검증해야 합니다.
시장 데이터
가격 소스를 연결하고 상품을 구독하십시오. Officer는 호가를 자동 수신하여 리스크 엔진에 제공하고 타임스탬프와 피드 진단 정보를 표시합니다.
문서 읽기

오픈 소스

의존하는 통제 수단을 직접 검토하십시오.

소스, 구성 및 API 계약을 직접 평가할 수 있습니다.

  • Apache-2.0

    Officer와 OpenPit는 오픈 소스입니다. 구현을 검토하고 직접 빌드하여 통합 요구 사항에 따라 동작을 검증하십시오.

  • 감사 이력

    제어 영역의 작업은 감사 기록을 추가합니다. 일반 감사 API는 개별 기록을 수정하지 않습니다. 백업 복원과 서비스 데이터 초기화는 저장된 이력을 교체하거나 삭제할 수 있습니다. 변경 불가능한 외부 보관소가 아닙니다.

  • 직접 관리하는 프로세스와 데이터베이스

    직접 통제하는 인프라에서 Officer를 실행하십시오. 시장 데이터 소스와 활성화된 거래 연결은 설정한 대상과 통신합니다. 주문 검증만으로 거래 장소에 주문을 보내지는 않습니다.

엔진 검토

OpenPit는 정책, 계좌 상태, 포지션, 예약 및 시장 데이터로 주문을 평가합니다. 판단을 재현하려면 주문과 한도값뿐 아니라 이러한 모든 입력이 필요합니다.

OpenPit 살펴보기

빠른 시작

명령 하나로 Officer를 시작하십시오.

Docker를 한 번 설치하십시오. 그런 다음 명령 하나를 붙여 넣고 브라우저에서 Officer를 여십시오. 프로그래밍 지식은 필요하지 않습니다.

Docker가 아직 설치되지 않았습니까? Docker 설치

Officer 시작

Docker Desktop을 시작하십시오. Windows에서는 PowerShell, macOS/Linux에서는 Terminal을 열고 이 명령을 붙여 넣은 다음 Enter를 누르십시오. 

docker run -d --name pit-officer --restart unless-stopped -p 127.0.0.1:8787:8787 -v pit-officer-data:/data ghcr.io/openpitkit/officer

Docker가 Officer를 다운로드하여 백그라운드에서 실행합니다. 컨테이너가 다시 시작되어도 데이터는 컴퓨터에 보관됩니다.

패널을 여십시오. 다음에도 같은 주소로 접속하십시오.

첫 시작이 완료될 때까지 기다린 후 아래 링크를 여십시오. 계정과 설정에 다시 접속할 수 있도록 북마크에 저장하십시오.

패널 열기
http://127.0.0.1:8787
패널을 열거나 Officer를 다시 시작하는 명령
Windows · PowerShell 
Start-Process http://127.0.0.1:8787
macOS 
open http://127.0.0.1:8787
Linux 
xdg-open http://127.0.0.1:8787

Officer를 중지한 경우 아래 명령으로 기존 컨테이너를 시작하십시오. 처음 설치할 때 사용한 명령을 반복하거나 데이터를 삭제하지 마십시오. 

docker start pit-officer

패널에서 계정, 상품, 가격 소스 및 리스크 한도를 추가하십시오. 결정에 사용할 서명 키를 생성하거나 가져온 다음 주문을 전송할 준비가 되면 거래 연결을 추가하십시오.

AI 에이전트용 가이드 (영어) 설정 참조

시작하기

첫 판단을 확인하십시오.

Officer를 로컬에서 실행하고 정책을 구성한 뒤 승인 또는 거절된 주문과 감사 기록을 확인하십시오. 이후 실행 시스템에서 그 판단을 어떻게 사용할지 선택하십시오.

Officer 사용해 보기

Apache-2.0 · 자체 호스팅 · 소스 공개

자주 묻는 질문

통합하기 전에 경계를 확인하십시오.

체결, 권한, 시장 데이터 및 배포는 통합 계약의 일부입니다.

제 데이터는 어디에 있나요?
계좌, 정책, 주문 및 감사 기록은 로컬 SQLite 데이터베이스에 저장됩니다. 설정된 시장 데이터 어댑터와 활성화된 거래 연결은 해당 제공업체와 통신합니다. 주문 검증 자체는 주문을 거래 장소에 보내지 않습니다.
어떤 시장과 연결을 사용할 수 있습니까?
내장 거래 연결에는 Interactive Brokers (TWS / IB Gateway), Binance, Alpaca 및 eToro가 포함됩니다. 가격 소스 어댑터에는 Interactive Brokers, Binance, Kraken, Coinbase, Alpaca, OKX, Bybit, OANDA, Finnhub 및 사용자 지정 소스가 있습니다. 각 연결의 지원 상품, 데이터 이용 권한, paper 또는 live 모드를 확인하십시오. 가격 소스 어댑터 자체는 주문 실행을 제공하지 않습니다.
Officer가 시장 가격을 자동으로 가져올 수 있습니까?
예. 패널에서 소스를 구성하고 상품을 구독하십시오. Officer는 가격을 자동 수신하여 리스크 검증을 위해 OpenPit에 제공합니다. 패널에서 호가 타임스탬프, 소스 상태 및 진단 정보를 확인할 수 있습니다. 제공업체 자격 증명, 데이터 이용 권한, 구성한 구독에 따라 사용 가능한 가격이 결정됩니다.
Officer가 주문을 전송합니까?
예. Officer는 활성화한 내장 거래 연결로 승인된 주문을 전송하고, 체결 업데이트를 내부 거래 기록에 반영합니다. 제공업체, 자격 증명 및 대상은 직접 구성합니다. Officer를 리스크 판단에만 사용하고 자체 시스템에서 실행할 수도 있습니다. 주문 평가와 전송은 별개의 작업입니다.
OpenPit과는 어떤 관계인가요?
OpenPit는 리스크 엔진입니다. Officer는 그 주변에 로컬 데이터베이스, 운영 패널, REST API 및 MCP 인터페이스를 제공합니다. 평가를 재현하려면 시장 데이터와 예약을 포함한 모든 엔진 입력과 상태가 같아야 합니다.
AI 에이전트가 제 한도를 우회할 수 있나요?
기본 MCP 인터페이스는 읽기 전용입니다. 상태 변경 도구는 운영자가 명시적으로 활성화해야 합니다. 계좌 차단과 차단 해제를 MCP에 노출하지 않습니다. 외부 실행 시스템은 Officer의 서명된 승인을 강제해야 합니다. 이 관문을 필수로 만들려면 에이전트가 브로커로 가는 다른 경로를 가지지 않아야 합니다. 도구 권한만으로 부여된 접근 권한의 모든 오용을 막을 수는 없습니다.
어떻게 시작하며 네트워크에 공개해도 됩니까?
Docker를 설치하고 빠른 시작의 명령 하나로 Officer를 시작한 다음 http://127.0.0.1:8787 을 여십시오. REST, HTTP MCP 및 API 참조는 같은 서비스를 사용합니다. 엔드포인트에는 내장 인증이 없습니다. 접근 경계를 제공하지 않는 한 서비스를 로컬로 유지하십시오.
승인 서명은 무엇을 보장합니까?
서명을 활성화하면 사전 거래 승인 및 거절 판단에 Ed25519 서명이 포함됩니다. 서명하지 않는 모드도 있으며, 모든 API 오류에 서명이 제공되는 것은 아닙니다. 실행 시스템은 서명, 승인 판단 및 연결된 주문 매개변수를 검증해야 합니다. 예약은 타이머로 해제되지 않습니다. 해당 확인, 체결 보고 또는 취소 흐름을 통해 수명 주기가 완료됩니다.