J2BOX ST · 워치 앱 · 타일 설치와 사용법

2026년 10월 16일 보유총액·알림 안내

첫 번째 계좌 타일의 기존 계좌손익 자리는 보유총액으로 변경되었습니다. 워치 앱 메인의 보유총액, 폰 위젯의 보유평가합계와 같은 보유 평가금액을 사용합니다. 총매입금액·현금 포함 전체 자산·계좌손익과는 다릅니다.

워치는 폰이 받은 변경 자료와 알림을 전달받으며 ST 서버를 직접 조회하지 않습니다. 휴대폰과 연결이 끊겼다면 마지막 저장값을 보여줄 수 있으므로 시각을 확인하세요. 워치에 별도 서버 API 키나 자체 모바일 회선을 설정할 필요는 없습니다.

미전달 알림은 폰-워치 재연결 또는 알림 권한 복구 후 다시 처리합니다. 동일 알림 ID는 중복 표시를 방지하며, 수신 확인은 워치 저장·알림 등록 확인이지 사용자의 읽음 확인이 아닙니다. 회원관리에서 보낸 메시지도 같은 방식으로 전달됩니다. 폰의 로그인·감시·인터넷 연결, 두 기기의 연결, 워치 알림 권한을 순서대로 확인하세요.

워치 앱·타일 화면 안내

이 페이지 상단의 워치 앱 따라 보기와 타일 따라 보기에서 울트라워치 실기기 화면 위에 번호별 설명을 띄워 봅니다. 이전·다음 또는 화면의 번호로 이동하고 우측 위 ×, 창 바깥 또는 Esc로 닫습니다. 개인 금액은 가린 편집본이며 시세·시각은 캡처 당시의 예시입니다.

워치 앱 안내는 전체 자산·주식총자산·보유총액의 차이, 네 계좌, 알림 내역, 계좌·알림 갱신, 휴대폰에서 계속을 설명합니다. 타일 안내는 계좌 손익·주요 지수·지수형 ETF·야간선물·단일종목 ETF를 각각 다룹니다. 실제 타일에서 계좌 카드를 누르면 해당 계좌를, 시세 타일을 누르면 앱 메인을 엽니다.

단일종목 ETF 타일은 회원이 입력한 지수·ETF가 있으면 그 목록을 표시하고 없으면 기본 종목을 표시합니다. 5종목 이상일 때는 다음 ›으로 네 종목씩 순환합니다. 캡처는 4종목이라 다음 버튼이 없습니다. 하단 자료 시각과 장 상태를 함께 확인하세요.

2026-09-27. J2BOX ST 워치 앱과 타일 설치 안내입니다. Wear OS 3 이상과 Android 휴대폰의 J2BOX ST 앱이 필요합니다.

다운로드와 Windows 설치 도우미

도구 ZIP에는 Install-Watch.ps1, Android Platform-Tools 37.0.1(adb와 필요한 DLL 포함), 라이선스 고지, 간단 안내가 들어 있습니다. 워치 APK는 위 링크로 따로 받으세요. 압축을 푼 뒤 ST-Watch.apk를 Install-Watch.ps1 옆에 놓습니다.

설치 폴더 빈 곳에서 Shift+마우스 오른쪽 버튼을 누르고 PowerShell 또는 터미널을 엽니다. 다음 명령을 입력합니다. 이 실행에만 정책을 적용하며 PC의 실행 정책을 영구 변경하지 않습니다.

powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-Watch.ps1

처음 연결이면 Y를 입력합니다. 워치의 페어링 코드 화면에 나온 IP:페어링포트를 입력한 뒤 코드를 입력합니다. 다음 질문에는 무선 디버깅 메인 화면의 IP:연결포트를 입력합니다. 설치 도우미는 Wear OS 기기인지 확인하고 J2BOX ST 앱을 설치합니다. 기존 앱 삭제나 데이터 초기화는 실행하지 않습니다.

직접 설치하는 순서

  1. 휴대폰과 워치를 제조사 앱에서 먼저 연결합니다. 두 기기를 같은 Wi-Fi에 연결합니다.
  2. 워치 설정 → 워치 정보 → 소프트웨어 정보에서 소프트웨어 버전을 여러 번 눌러 개발자 모드를 켭니다. 기종별 메뉴 이름은 다를 수 있습니다.
  3. 개발자 옵션에서 ADB 디버깅·무선 디버깅을 켭니다. '새 기기 페어링' 화면의 주소:페어링포트와 코드를 적습니다.
  4. PC에 Android SDK Platform-Tools의 adb가 있으면 터미널에서 아래를 실행합니다. 숫자는 워치에 표시된 값으로 바꿉니다. 페어링 포트와 연결 포트는 서로 다릅니다.
adb pair 192.168.0.20:페어링포트
adb connect 192.168.0.20:연결포트
adb install -r "C:\Users\Admin\Desktop\st\Watch\ST-Watch.apk"
  1. 휴대폰 앱에서 로그인하고 워치의 J2BOX ST 주식을 엽니다. 자동으로 연결됩니다.
  2. 워치 타일 추가 화면에서 개인 계좌, 공통 지수, 공통 ETF, 공통 야간선물, 개인 보유종목 타일을 추가합니다. 설치 직후 안 보이면 타일 추가 화면을 다시 엽니다.
  3. 워치에 API 키를 입력하지 않습니다. 로그인한 계정의 정보가 자동으로 연결됩니다.
  4. 설치가 끝나면 무선 디버깅을 끕니다.

워치 앱 사용법

휴대폰과 워치를 페어링하고 두 기기에 앱을 설치합니다. 휴대폰 앱에서 로그인한 뒤 워치의 J2BOX ST 주식을 열면 자동으로 연결·갱신됩니다. 워치에 주소나 API 키를 입력할 필요가 없습니다.

타일 설치·사용법

타일은 ST-Watch.apk 안에 함께 들어 있습니다. 별도 타일 APK를 설치하지 않습니다.

  1. 워치 시계 화면에서 좌우로 넘겨 타일 끝의 타일 추가를 엽니다. 기기에 따라 화면을 길게 누르거나 휴대폰의 워치 관리 앱에서 타일을 추가합니다.
  2. 개인 계좌, 공통 지수, 공통 ETF, 공통 야간선물, 회원 보유종목 중 필요한 타일을 선택합니다.
  3. 추가한 타일로 이동하면 인증된 저장 요약을 읽습니다. 표시된 자료의 기준 시각을 확인하세요.
  4. 타일이 목록에 없으면 워치 앱을 한 번 열고 타일 추가 화면을 다시 엽니다. 설치 실패 메시지가 있었다면 먼저 설치를 해결합니다.
  5. 로그인한 계정에 맞춰 자동으로 연결·갱신됩니다. 절전·네트워크 상태에 따라 반영이 늦어질 수 있습니다.

연결되지 않을 때

페어링 포트와 연결 포트를 바꾸어 넣지 않았는지, 같은 Wi-Fi인지 확인합니다. code 입력 실패 시 워치에서 새 페어링 코드를 엽니다. 설치 서명이 다르다는 오류가 나면 기존 앱을 바로 삭제하지 말고 사용 중인 J2BOX ST APK와 서명을 확인하세요. 설치 후에는 무선 디버깅을 끕니다.

커뮤니티 알림 — J2BOX ST 주식

  1. 커뮤니티 상단 알림 설정에서 워치 알림과 받을 글·댓글 종류를 선택하고 저장합니다.
  2. 워치 앱을 처음 열 때 나타나는 Android 알림 권한을 허용합니다.
  3. 휴대폰 앱의 ⋮ → 백그라운드 알림 시작을 켜 두면 새 소식을 워치에서도 받을 수 있습니다.

로그인한 휴대폰과 워치는 자동으로 연결됩니다. 절전·네트워크 상태에 따라 알림이 늦어질 수 있습니다.

오류가 표시될 때

워치 앱과 타일에 나타난 오류 메시지를 확인하세요. 먼저 휴대폰의 인터넷 연결과 휴대폰-워치 연결을 확인하고, 인증이 만료되었다면 휴대폰 앱에서 다시 로그인하세요. 해결되지 않으면 표시된 오류 코드와 실패 작업을 관리자에게 전달합니다. API 키나 비밀번호는 보내지 않습니다.

KB증권 OpenAPI 준비와 연결

J2BOX ST의 증권 API는 KB증권 OpenAPI를 사용합니다. 위탁계좌 잔고·손익·거래내역을 정상적으로 이용하려면 본인의 KB증권 위탁계좌와 OpenAPI APP Key·App Secret이 필요합니다.

  1. KB증권 OpenAPI를 새 탭에서 열고 계좌·서비스 신청 요건을 확인합니다.
  2. 본인의 위탁계좌로 OpenAPI 사용을 신청하고 APP Key와 App Secret을 발급받습니다. 증권사 이용 안내를 참고하세요.
  3. J2BOX ST 회원 로그인 후 API 연결에서 APP Key와 App Secret을 입력합니다. 증권사 인증에 성공해야 연결이 완료됩니다.
  4. 위탁 계좌의 잔고·손익·거래내역과 자료 기준 시각을 확인합니다. 연결하지 않은 경우 해당 목록에 API 연결 안내가 표시됩니다.

공개 야간선물·커뮤니티 열람에는 개인 API 키가 필요하지 않습니다. 로그인 후 직접 입력하는 종목·계좌 기록과 공통 시세는 개인 API 연결과 구분됩니다. 폰·워치는 웹 계정에 연결해 조회하며 워치에는 API 키를 입력하지 않습니다. API를 통한 매입·자동매입 기능은 제공하지 않습니다.

탈퇴할 때 API 정보 처리

회원 탈퇴가 완료되는 즉시 J2BOX ST에 저장된 KB증권 OpenAPI APP Key·App Secret과 인증 토큰을 삭제하고 기기 연결을 해제합니다. KB증권에서 발급한 키 자체의 폐기는 KB증권 OpenAPI에서 별도로 처리하세요. 서버에서 폐기된 계정으로는 API 조회나 기기 동기화를 할 수 없습니다. 오프라인 기기의 기존 화면은 자동으로 즉시 지워지지 않을 수 있으므로 앱의 로그아웃 또는 앱 데이터 삭제도 진행하세요.

메인 상단 자산 요약

기존 상단 요약을 전체 자산, 주식총자산 두 카드로 교체했습니다. 각 카드에 자산·손익·손익률을 표시합니다. 전체는 연금·ISA·위탁+CMA, 주식은 연금·ISA·위탁만 포함합니다. 보유 종목 평가손익과 수동 자산현황 손익을 중복 합산하지 않습니다.

보유 종목 합계 표시

워치 메인의 주식총자산 아래, 연금 계좌 위에 보유총액과 손익(율)을 두 줄로 표시합니다. 연금·ISA·위탁의 보유종목 평가액과 순평가손익을 합산하며 손익률은 합산 매입액 기준입니다. CMA와 수동 입력 자산은 이 보유 합계에 포함하지 않습니다. 필요한 계좌 자료가 없으면 대시로 표시합니다. 워치 앱의 금액은 모든 페이지에서 원 단위 접미사 없이 표시합니다.

단일종목 ETF 타일 · 회원별 목록 (0.3.14)

웹의 입력형 주요 지수 · ETF 중 지수·ETF 등록 목록이 있으면 같은 회원의 목록을 타일에 표시합니다. 목록이 비어 있을 때만 기존 단일종목 ETF 4종목을 표시합니다. 목록이 4개를 초과하면 다음 ›으로 4개씩 넘깁니다. 등록 종목의 시세가 없으면 ‘—’이며 다른 종목의 가격을 대입하지 않습니다. 웹 목록 변경은 휴대폰과 워치의 다음 동기화에 반영됩니다.

0.3.15 연결 상태 표시

메인 상단은 실제 연결 확인 결과에 따라 휴대폰 연결됨, 연결 끊김, 등록 필요, 인증 확인 필요를 표시합니다. 연결 확인이 10초 안에 끝나지 않으면 실패 상태로 전환하여 확인 중 문구가 계속 남지 않습니다. 연결됨은 휴대폰 통신 상태이며 저장 시세의 최신성을 보증하지 않습니다. 폰 0.3.17은 워치의 재연결 요청에서 서버 인증을 다시 검증하고 만료된 인증을 재등록합니다.