J2BOX ST · 휴대폰 앱 · 위젯 사용법

2026년 10월 15~16일 알림·워치 전달 개편

폰에서 받은 변경 자료와 알림을 연결된 워치로 전달합니다. 워치가 ST 서버를 따로 조회하지 않으므로 폰의 로그인·감시 상태와 폰-워치 연결을 확인하세요. 앱 화면을 항상 열어 둘 필요는 없지만 감시 중지·절전·권한 제한·통신 장애가 있으면 수신이 지연될 수 있습니다.

폰·워치 양쪽에 이 기능을 지원하는 업데이트가 필요합니다. 웹의 혼합 카드·그래프·표 복사·원화 환산은 웹 사용자 매뉴얼의 개편 안내를 참고하세요.

화면으로 배우는 사용법

이 페이지 상단의 폰 앱 따라 보기와 위젯 따라 보기에서 울트라폰 실기기 화면을 보며 번호 또는 이전·다음 버튼으로 설명을 확인합니다. 우측 위 ×, 창 바깥 또는 Esc로 닫고 언제든 다시 열 수 있습니다. 안내 이미지의 버튼은 실제 계좌 변경이나 알림 발송을 실행하지 않습니다. 개인 금액을 가린 편집본이며, 위젯 선택 화면의 —는 설치 전 미리보기입니다.

위젯 안내에는 기본 3×2, 정사각 3×3, 세로 3×4, 기존 가로 4×2, 전체·주식 요약 4×2의 선택 방법이 포함됩니다. 실제 홈에 놓인 최신 요약 위젯의 보유손익합계·보유평가합계, 네 계좌, 전체·주식 자산, 시간·새로고침을 각각 설명합니다.

휴대폰 APK 다운로드 · 워치 설치·타일 사용 안내

  1. Android 8 이상 휴대폰으로 ST-Alerts.apk를 전달합니다. 파일을 눌러 설치합니다. Android가 묻는 경우 해당 파일 앱에만 '이 출처 허용'을 켭니다.
  2. J2BOX ST 주식 앱(J2BOX ST 휴대폰 앱)을 엽니다. 앱 실행 즉시 J2BOX ST 주식 서비스가 자동으로 열립니다. 이용자가 서비스 주소를 입력할 필요는 없습니다.
  3. 앱 화면에서 개인 로그인하면 휴대폰과 계정이 자동으로 연결됩니다. 상단에 계좌 정보 갱신 완료 · 위젯 사용 가능이 표시될 때까지 잠시 기다립니다.
  4. 홈 화면을 길게 누르고 위젯 목록에서 개인 계좌 위젯을 추가합니다. 가로·세로·정사각 위젯이 있습니다.
  5. 계속 동기화하려면 ⋮ → 알림 감시 설정 → 감시 켜기를 누르고 알림 권한을 허용합니다. 중단하려면 같은 메뉴에서 감시 중지를 누릅니다. Android의 절전 정책에 따라 동기화가 지연될 수 있습니다.
  6. 페어링된 워치에 J2BOX ST 주식을 설치해 열면 자동으로 연결됩니다. 워치에 API 키를 입력하지 않습니다.
  7. 계정 사용을 마치면 앱 안 주식 웹 화면의 로그아웃 버튼을 누릅니다. 로컬 개인 캐시를 지우고 서버 기기 연결도 폐기합니다. 오프라인 폐기는 통신 복구 후 재시도됩니다.

홈 화면 위젯 추가와 읽는 법

  1. 앱에서 개인 로그인하면 자동으로 계정에 연결됩니다. 휴대폰을 재시작하거나 앱을 닫았다 열 필요는 없습니다.
  2. 휴대폰 홈 화면의 빈 곳을 길게 누르고 위젯 메뉴를 엽니다.
  3. 개인 계좌 위젯을 찾아 가로·세로·정사각형 중 원하는 모양을 추가합니다.
  4. 크기 조절 테두리가 표시되면 드래그해 읽기 좋은 크기로 맞춥니다.
  5. 위젯의 연금·ISA·위탁·CMA 카드를 누르면 앱의 해당 계좌 내역으로 이동합니다. 새 3단 위젯의 하단 전체·주식 자산 카드는 둘 다 나의 자산 기록을 엽니다. 계좌 요약과 기준 시각을 함께 확인하세요.
  6. 위젯의 시간·회전 화살표 영역을 누르면 갱신을 요청합니다. 새 전체·주식 요약 4×2에서는 이 버튼이 상단 중앙에 있습니다. 웹 화면을 다시 불러오려면 앱의 ⋮ → 웹 새로고침을 누릅니다.

위젯에는 연결한 회원의 저장된 계좌 요약이 표시됩니다. 비어 있는 값은 0원으로 해석하지 않습니다. 로그아웃·기기 연결 해제 후에는 이전 회원의 자료를 계속 표시하지 않습니다. 위젯 배치와 크기 조절 메뉴는 휴대폰 제조사에 따라 다릅니다.

커뮤니티 알림 — 휴대폰 앱

  1. 앱에서 로그인한 뒤 커뮤니티 상단 알림 설정을 엽니다.
  2. 앱 알림 (휴대폰)과 받을 글·댓글 종류를 선택하고 저장합니다. 여러 종류를 함께 선택할 수 있습니다.
  3. 앱 상단의 ⋮ → 알림 감시 설정 → 감시 켜기를 누르고 휴대폰 알림 권한을 허용합니다. 앱 화면을 보고 있지 않을 때도 새 소식을 받을 수 있습니다.

로그인 후 계정 연결과 갱신은 자동으로 진행됩니다. 알림을 멈추려면 ⋮ → 알림 감시 설정 → 감시 중지를 누르거나 안드로이드 설정에서 앱 알림을 해제합니다. 절전·네트워크 상태에 따라 알림이 늦어질 수 있습니다.

업데이트와 문제 해결

새 APK를 다운로드해 기존 앱 위에 설치합니다. 서명이 다르다는 오류가 나면 관리자에게 문의하세요. 임의로 앱 데이터를 지우지 않습니다. 알림이 오지 않으면 앱 알림 권한, 백그라운드 동기화, 커뮤니티의 알림 수신 위치 설정을 확인하세요. 기기 조회·HTTPS 오류는 앱 상단에 표시됩니다.

전체 웹 사용법 · 워치 설치와 타일 사용법

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 조회나 기기 동기화를 할 수 없습니다. 오프라인 기기의 기존 화면은 자동으로 즉시 지워지지 않을 수 있으므로 앱의 로그아웃 또는 앱 데이터 삭제도 진행하세요.

자동 갱신: 로그인하면 계좌·위젯 자료와 워치 연결을 자동으로 확인합니다. 앱 상단 계좌 내역을 누르거나 ⋮ → 계좌 손익 · 감시 상태를 선택하면 계좌 손익과 감시 상태를 확인합니다.

로그인 정보 저장과 자동 입력

휴대폰 앱에서 로그인에 성공하면 로그인 정보 저장을 제안합니다. 저장을 선택하면 기기 암호화 저장소에 보관하며, 같은 사이트의 다음 로그인창에서 빈 아이디·비밀번호 칸을 자동으로 채웁니다. 로그인 버튼은 직접 누릅니다. 이미 입력한 내용은 덮어쓰지 않습니다. 저장을 원하지 않으면 이번에는 안 함을 선택합니다. 기존 수동 저장 자료는 다음 로그인 성공 시 저장 제안에 동의하면 자동 입력용으로 갱신됩니다. 앱 메뉴의 로그인 정보 관리에서 저장정보를 삭제할 수 있습니다. 웹 브라우저의 암호 저장은 브라우저 지원 여부와 사용자 설정에 따릅니다.

여러 휴대폰의 알림 우선순위

같은 회원으로 여러 휴대폰을 사용하는 경우, 서버에 연결 등록되어 있고 최근 실제 연결이 확인된 워치의 휴대폰이 주식 알림을 우선 수신합니다. 워치가 없는 폰이 먼저 조회해도 우선 폰을 기다립니다. 우선 폰의 연결이 끊기거나 확인 시각이 오래되면 다른 폰이 수신하며, 응답이 없는 경우에도 75초 대기 이후 다른 폰이 수신할 수 있습니다. 이미 전송 중인 알림은 기존 전송 확인 대기 규칙이 적용됩니다. 워치 연결 폰이 여러 대라면 먼저 수신권을 확보한 한 대가 받습니다. 동일 알림을 모든 폰에 중복 발송하지 않습니다. 다중 폰 사용 시 장내 확인 간격은 최대 60초이며, Android 절전·네트워크 상태에 따라 실제 전달은 지연될 수 있습니다. 우선순위 적용에는 서버 파일과 새 휴대폰 APK가 모두 필요합니다.

전체·주식 요약 위젯

위젯 목록에서 개인 계좌 · 전체·주식 요약 4×2를 선택하면 기존 계좌 카드 아래에 두 요약 카드가 표시됩니다. 왼쪽은 첫 줄에 전체 자산, 둘째 줄에 전체 손익(손익률)을 표시합니다. 오른쪽은 첫 줄에 주식총자산, 둘째 줄에 주식총손익(손익률)을 표시합니다. 전체는 연금·ISA·위탁과 CMA를 합하고, 주식은 연금·ISA·위탁만 합합니다. 각 손익률은 각각의 자본금 기준이며, 자료가 없거나 자본금이 0 이하이면 해당 값은 —로 표시됩니다. 기존 위젯은 유지됩니다. 기본 3×2 위젯에도 미리보기가 제공됩니다.

폰 0.3.17: 워치의 재연결 요청 시 로컬 등록 표시만 신뢰하지 않고 서버 인증을 확인합니다. 인증 거절(401)일 때 로그인된 폰을 통해 새 워치 등록을 전송하며, 일시적 통신 오류는 등록을 교체하지 않습니다.

폰 0.3.18: 위젯의 계좌 카드는 해당 계좌 제목을 기준으로 이동합니다. 초기 자료 로딩으로 배치가 바뀌면 잠시 위치를 보정하며, 화면을 직접 터치하거나 스크롤하면 보정을 중단합니다. 전체·주식 요약 카드에서는 앱의 나의 자산 기록으로 이동합니다.