사용설명서

Ana Terminal은 국내외 주식·ETF, 지수, 환율, 원자재, 금리, 선물, 암호화폐 시세와 차트를 한 화면에서 보는 데스크톱 프로그램입니다. 이 문서는 버전 - 기준입니다.

1. 시작하기

Ana Terminal은 두 부분으로 이루어져 있습니다.

• 앱(클라이언트): 내 컴퓨터에 설치해 실행하는 프로그램입니다.
• 서버: 시세를 모으고 관심종목을 저장하는 서버입니다. 회사나 운영자가 설치해 둔 서버에 앱이 접속합니다.

앱은 서버를 통해서만 데이터를 받습니다. 외부 웹브라우저나 웹페이지를 열지 않고 모든 정보를 앱 안에서 보여줍니다.

2. 설치

Windows

1. 다운로드에서 Windows용 ZIP 파일을 받습니다.
2. 파일을 마우스 오른쪽 버튼으로 눌러 압축 풀기를 합니다. (예: 문서\AnaTerminal)
3. 압축을 푼 폴더의 AnaTerminal.Client.exe를 실행합니다.
4. "Windows의 PC 보호" 창이 나오면 추가 정보 → 실행을 누릅니다. 코드 서명 전 배포판이라 처음 한 번 나오는 경고입니다.

바탕화면에 바로가기를 만들려면 AnaTerminal.Client.exe를 오른쪽 버튼으로 눌러 바로 가기 만들기를 선택하세요.

macOS

1. 다운로드에서 내 Mac에 맞는 파일을 받습니다.
   • Apple 메뉴 → 이 Mac에 관하여에서 '칩'이 Apple M…이면 Apple Silicon, '프로세서'가 Intel이면 Intel 버전입니다.
2. 받은 .tar.gz 파일을 더블클릭하면 Ana Terminal.app이 생깁니다.
3. Ana Terminal.app을 응용 프로그램 폴더로 옮깁니다.
4. 처음 실행할 때는 앱을 Control 키를 누른 채 클릭(또는 오른쪽 클릭) → 열기 → 확인 창에서 열기를 누릅니다. 코드 서명·공증 전 배포판이라 처음 한 번 필요합니다.

xattr -dr com.apple.quarantine "/Applications/Ana Terminal.app"

업데이트와 삭제

• 업데이트: 새 버전을 받아 기존 폴더(또는 앱)를 바꿔 넣습니다. 서버 주소를 바꿔 썼다면 appsettings.json은 미리 보관했다가 다시 넣으세요. 관심종목은 서버에 저장되므로 그대로 남습니다.
• 삭제: Windows는 압축을 푼 폴더를, macOS는 Ana Terminal.app을 지우면 됩니다.

3. 서버 연결 설정

앱이 접속할 서버 주소는 실행 파일 옆의 appsettings.json에 있습니다. 배포판에는 운영 서버 주소가 미리 들어 있으므로 보통은 바꿀 필요가 없습니다.

{
  "ApiBaseUrl": "https://api.example.com",
  "MarketDataBaseUrl": "https://marketdata.example.com"
}

• ApiBaseUrl: 종목 검색과 관심종목을 담당하는 API 서버 주소
• MarketDataBaseUrl: 시세·차트·실시간 연결을 담당하는 시세 서버 주소

파일을 고친 뒤 앱을 다시 실행하면 적용됩니다.

4. 화면 구성

1. 종목 검색: 종목을 찾아 현재가·차트에 엽니다.
2. 시장 개요: 주요 지수·환율·원자재·금리·암호화폐.
3. 관심종목: 내가 모아 둔 종목 목록.
4. 차트: 선택한 종목의 캔들 차트와 거래량.
5. 현재가: 선택한 종목의 시세 상세.
6. 상태 표시줄: 서버 연결 상태와 데이터 출처별 상태.

패널 사이의 경계선을 마우스로 끌면 패널 크기를 조절할 수 있습니다.

5. 종목 검색

1. 화면 위쪽 검색창에 종목코드나 종목명을 입력합니다. 예: 005930, 삼성전자, apple, BTC
2. 입력을 멈추면 잠시 뒤 결과 목록이 나타납니다.
3. 결과를 클릭하면 그 종목의 현재가와 차트가 열리고, 관심종목의 종목 입력란에도 심볼이 채워집니다.

• Enter: 첫 번째 결과 열기 · Esc: 결과 목록 닫기
• 전체 심볼(예: UPBIT:KRW-BTC)이나 시장 코드(예: KRX)로도 검색할 수 있습니다.
• 목록에 없는 해외 종목(예: toyota, lvmh)은 검색하면 자동으로 찾아 추가합니다. 처음 한 번은 1~2초 걸릴 수 있습니다.
• 국내 종목은 한글 이름으로 검색하세요. (국내 종목의 영문 이름은 아직 제공하지 않습니다.)

6. 종목 심볼 규칙

모든 종목은 시장:코드 형식의 심볼로 구분합니다. 관심종목에 직접 입력할 때 이 형식을 씁니다.

암호화폐는 거래소마다 가격이 달라 같은 비트코인도 거래소별로 다른 종목입니다.

7. 현재가

검색이나 관심종목에서 종목을 열면 오른쪽 현재가 패널에 표시됩니다.

• 현재가 · 전일대비 · 등락률: 상승은 빨간색, 하락은 파란색입니다.
• 시가 · 고가 · 저가 · 전일 종가 · 거래량 · 최종 갱신 시각(내 컴퓨터 시간 기준).
• 출처: 시세를 받은 곳(예: NAVER, UPBIT).

표시 배지

관심종목과 시장 개요 목록에서는 장중이 아닐 때만 장 상태 배지를 표시합니다. 패널 오른쪽 위 ✕를 누르면 현재가를 닫고 실시간 수신을 멈춥니다.

8. 차트

• 주기: 1분, 5분, 15분, 60분, 일, 주, 월
• 조회 기간: 최근(최근 300개), 1일, 1주, 1개월, 3개월, 1년, 5년
• 위쪽은 캔들(시가·고가·저가·종가), 아래쪽은 거래량입니다. 두 차트는 함께 움직입니다.
• 마지막 캔들은 실시간 시세로 계속 갱신됩니다.

마우스 조작

• 요청한 기간이 너무 길면 최근 5,000개만 표시하고 안내 문구를 보여줍니다.
• "데이터 없음"이 나오면 해당 주기를 출처가 제공하지 않거나(예: 일부 해외 종목의 분봉), 장이 열리지 않아 데이터가 없는 경우입니다. 주말에는 '최근' 1분봉이 비어 있을 수 있으니 기간을 1주로 바꿔 보세요.

9. 관심종목

목록 만들기·이름 바꾸기·삭제

1. 목록 이름 입력란에 이름을 쓰고 새 목록을 누릅니다. (최대 50자)
2. 위쪽 목록 선택 상자에서 목록을 고릅니다.
3. 이름을 바꾸려면 새 이름을 쓰고 이름 변경을 누릅니다.
4. 삭제를 누르면 확인 창이 나타나고, 삭제를 누르면 목록과 담긴 종목이 함께 삭제됩니다.

종목 추가·정렬·삭제

• 추가: 검색에서 종목을 고르면 입력란에 심볼이 채워집니다. 종목 추가 또는 Enter를 누르세요. 심볼(예: KRX:005930)을 직접 입력해도 됩니다.
• 순서 바꾸기: 각 행의 ▲ ▼ 버튼 또는 오른쪽 클릭 메뉴의 위로 · 아래로.
• 삭제: 행의 ✕ 버튼 또는 오른쪽 클릭 메뉴의 삭제. 확인 창에서 삭제를 누르면 지워집니다.
• 열기: 행을 더블클릭하거나 오른쪽 클릭 메뉴의 현재가/차트 열기.

한 목록에는 최대 100종목을 담을 수 있고, 같은 종목은 한 번만 들어갑니다. 목록은 서버에 저장되어 앱을 다시 실행하거나 다른 컴퓨터에서 같은 서버에 접속해도 그대로입니다.

10. 시장 개요

국내·해외 지수, 환율, 원자재, 금리, 암호화폐 대표 종목을 구역별로 보여줍니다. 각 행에는 현재값, 전일대비, 등락률과 당일 흐름을 보여주는 미니 차트가 있습니다. 시세가 아직 없는 항목은 -로 표시됩니다. 행을 클릭하면 현재가와 차트가 열립니다. 표시 종목은 서버 운영자가 정합니다.

11. 상태 표시줄

12. 시세 데이터 이해하기

• 실시간과 지연: 암호화폐 거래소 공식 API 시세는 실시간입니다. 주식·지수·환율 등 웹 데이터를 주기적으로 읽는 출처의 시세는 몇 초에서 몇 분 늦을 수 있어 지연으로 표시합니다.
• 출처 자동 전환: 한 출처에 장애가 나면 같은 종목을 제공하는 다른 출처로 바뀝니다. 이때 출처 표시가 바뀌고, 출처마다 기준 시점이 달라 값이 조금 달라질 수 있습니다.
• 전일대비 기준: 주식·지수는 전일 종가 기준입니다. 해외 암호화폐 거래소(바이낸스 등)는 거래소 기준대로 최근 24시간 기준입니다.
• 장 상태: 국내외 주식·지수는 출처가 알려주는 상태를 쓰므로 휴장일도 반영됩니다. 그 밖의 해외 종목은 거래소 시간표로 판단해 공휴일에도 '장중'으로 보일 수 있습니다.
• 참고용 정보: 표시되는 모든 정보는 참고용이며 정확성과 완전성을 보장하지 않습니다. 투자 판단은 본인 책임입니다.

13. 문제 해결

서버에 연결되지 않아요

• 상태 표시줄의 API 서버·시세 서버가 '끊김'이면 인터넷 연결과 회사 네트워크(방화벽, VPN)를 확인하세요.
• appsettings.json의 서버 주소가 맞는지 확인하세요. (3. 서버 연결 설정)
• 서버 점검 중일 수 있습니다. 앱은 자동으로 다시 접속하므로 켜 둔 채로 기다려도 됩니다.

가격이 바뀌지 않아요

• 장 마감 배지가 있으면 장이 끝난 상태입니다.
• 지연 배지가 있으면 지연 시세이거나 출처에 장애가 있는 상태입니다. 상태 표시줄의 출처 상태를 확인하세요.

종목이 검색되지 않아요

• 종목코드로 검색해 보세요. 국내 종목은 한글 이름으로 검색해야 합니다.
• 해외 종목은 영문 이름이나 티커로 검색하세요(예: nvidia, NVDA).

관심종목에 추가가 안 돼요

• "이미 목록에 있는 종목입니다": 같은 종목은 한 번만 넣을 수 있습니다.
• "목록당 최대 100종목": 다른 목록을 만들어 나눠 담으세요.
• "종목을 찾을 수 없습니다": 검색에서 종목을 골라 추가하세요. 심볼을 직접 입력할 때는 심볼 규칙을 확인하세요.

macOS에서 앱이 열리지 않아요

2. 설치 → macOS의 처음 실행 방법과 xattr 명령을 참고하세요.

14. 단축키