WATCH TOGETHER — 조건이 맞은 종목만 함께 찾기

혼자서는 API 호출 한도 때문에 전 종목을 자주 훑을 수 없습니다. WATCH TOGETHER 는 참여한 에이전트들이 종목을 나눠서 조건을 보고, 조건이 맞은 종목만 서로 알려주는 P2P 네트워크입니다.

무엇이 오가나

  • 오가는 것은 "종목 X 가 봉 t 에 조건 C 를 충족했다(또는 안 했다)" 는 판정뿐입니다. 가격·지표값·주문·API 키는 오가지 않습니다.
  • 기본 경로는 공용 조건표입니다 — 참여자 모두가 같은 지표 조건 목록(RSI·이동평균·교차·MACD·볼린저 등)을 자기 몫의 종목에 판정해 나눕니다. 그래서 내 전략의 정확한 조건은 기기 밖으로 나가지 않고, 내 에이전트가 받은 판정에서 내 조건의 후보만 고릅니다. 조건표로 좁힐 수 없는 조건은 내 에이전트가 혼자 봅니다.
  • 받은 알림은 내 에이전트가 그 종목을 내 키로 다시 조회해서 확인합니다. 확인된(confirmed) 알림만 전략에 전달되고, 틀렸거나(refuted) 확인 못 한(unverified) 알림으로는 주문이 나가지 않습니다.
  • 서버는 피어를 소개만 하고 알림을 중계하지 않습니다. 에이전트끼리 직접 연결합니다.

켜는 법

1. 설치 스크립트(리눅스·macOS·Windows)로 에이전트를 설치하면 P2P 데몬(soritrading-p2p)이 함께 설치됩니다. P2P 포트(기본 TCP 4001 · UDP 4002, 설치 스크립트가 출력)를 서버 방화벽과 클라우드 콘솔의 방화벽(보안 그룹·네트워킹 탭) 양쪽에서 열어 두세요. 닫혀 있으면 에이전트 카드에 "외부 접속 불가"로 보이고, 다른 노드가 먼저 걸어올 수 없어 연결이 잘 안 됩니다.

2. 에이전트 관리 화면(/trading/agents)의 에이전트 카드에서 P2P 연결 상태를 확인합니다 — "네트워크 참여 중 · 피어 N개"가 보이면 참여 중입니다.

3. 같은 화면의 WATCH TOGETHER 공유 설정에서 계정 단위로 고릅니다(에이전트에는 1분 안에 반영).

  • 다른 사용자와 공유 — 끄면 내 계정의 기기끼리만 연결합니다
  • KRX 종목 포함 — 끄면 KRX 종목 알림을 보내지도 받지도 않습니다
  • 실거래 run 에 시그널 전달 — 끄면 확인된 알림은 페이퍼 run 에만 갑니다(이 설정은 run 을 새로 만들지 않습니다)
  • 미국 주식 수집 분담 — 켜면 IBKR 연결이 켜져 있을 때 미국 종목 일봉을 다른 노드와 나눠 모읍니다. 끄면 내가 고른 종목만 모읍니다

알아둘 것

  • 기여해야 받습니다. 우리 에이전트는 받는 시장의 판정을 자동으로 함께 보내고, 받기만 하는 노드는 우선순위가 내려갑니다. 외부 프로그램용 API 도 기여 중일 때만 답합니다.
  • 내 몫이 먼저입니다. 에이전트는 내 거래·조회에 쓸 유량을 남겨두고 남는 만큼만 공유합니다. 거래가 임박하면(집중 모드) 잠시 보내기·재조회를 멈추고 받기만 합니다 — 주문은 막지 않습니다.
  • 거래 키가 있는 서버의 IP 를 드러내고 싶지 않으면 P2P 데몬을 별도 서버에 설치하고 에이전트를 원격으로 붙일 수 있습니다(에이전트 카드의 안내 참고).

내 프로그램에서 받기 (API)

내 봇·스크립트가 P2P 데몬에 WebSocket 으로 붙어 조건을 걸고 확인된 알림을 받을 수 있습니다(읽기 전용 — 주문·키 기능 없음). JavaScript·Python 클라이언트와 프로토콜 설명은 P2P WebSocket API 안내(영문)에 있습니다.

알림은 판단 재료일 뿐 매매 권유가 아닙니다. 소리트레이딩는 투자 판단이나 조언을 제공하지 않습니다.