도움말

거래소 계정

거래소 계정을 연결하면 Watchlist.top이 매매 권한이나 출금 권한 없이도 당신의 프라이빗 트레이딩 컨텍스트를 보여줄 수 있습니다. 연결은 read-only로만 동작합니다: 앱은 API 키를 확인하고, 포지션, 오더, 체결, 잔고를 불러오며, 원하면 차트에 트레이딩 마커도 표시할 수 있습니다.

이 섹션에서 다루는 내용

연결 가능한 항목: Binance USD-M, Bybit, OKX의 read-only API 키. Binance는 읽기 권한 활성화, 출금 비활성화, USD-M Futures 계정 데이터 읽기 가능 상태가 필요합니다.
키가 반드시 read-only여야 하는 이유: Watchlist.top은 거래소 계정을 포지션, 오더, 체결, 잔고, 트레이딩 히스토리 조회용으로만 사용합니다. 앱은 거래소 오더를 생성, 수정, 취소하지 않습니다.
여러 계정이 동작하는 방식: 한 사용자는 여러 계정을 연결할 수 있으며, 같은 거래소 계정도 여러 개 연결할 수 있습니다. 저장된 각 연결에는 자체 상태, 검증, 히스토리 버튼, 연결 해제, 삭제가 있습니다.
"개요" 탭에 표시되는 항목: 전체 계정 수, 연결된 계정 수, 오픈 포지션 수, 지정가 오더 수, 종료된 오더 수, 체결 수, 잔고 수, 종료된 포지션 수, 마지막 검증, 마지막 동기화.
"개요"에서 카드를 클릭하면 일어나는 일: 포지션, 오더, 체결, 잔고, 종료된 포지션 카드를 클릭하면 동기화된 계정 데이터 테이블이 열립니다.
"마지막 검증"의 의미: 저장된 API 연결이 거래소에서 권한 및 read-only 요구사항 기준으로 마지막으로 검증된 시간입니다.
"마지막 동기화"의 의미: 계정 데이터가 거래소에서 Watchlist.top으로 마지막 동기화된 시간입니다.
현재 동기화가 동작하는 방식: 앱이 활성 상태에서 계정 데이터를 요청하면, 백엔드는 저장된 데이터를 반환하고 거래소 요청 한도를 고려해 연결된 거래소 계정을 백그라운드에서 업데이트합니다.
히스토리 추가 로드가 동작하는 방식: "히스토리" 버튼을 누르면 선택한 계정에 대해 백그라운드 로드가 시작됩니다. 1일, 7일, 30일 기간을 사용할 수 있습니다. 히스토리 추가 로드는 사용자 요청보다 우선순위가 낮습니다.
히스토리 진행 상태에 표시되는 항목: 기간, 상태, 로드된 체결, 종료된 오더, 종료된 포지션, 업데이트 시간. 다이얼로그를 닫아도 앱은 백그라운드에서 상태를 계속 조회할 수 있습니다.
차트 표시를 켜는 방법: 먼저 거래소 계정 -> 설정에서 타임프레임을 하나 이상 선택한 뒤, 차트 패널의 $ 버튼으로 트레이딩 마커를 빠르게 켜고 끌 수 있습니다.
타임프레임 필터의 의미: 포지션, 오더, 트레이딩 히스토리 마커는 선택한 차트 타임프레임에서만 표시됩니다. 타임프레임을 하나도 선택하지 않으면 차트의 트레이딩 데이터는 비활성화됩니다.
히스토리 표시 방법: "히스토리 표시 방식"은 "포지션" 또는 "체결"로 설정할 수 있습니다. 활성 버튼을 다시 클릭하면 선택이 해제되고, 종료된 히스토리는 차트에 그려지지 않습니다.
종료된 포지션이 그려지는 방식: 진입과 청산은 점선으로 연결된 삼각형으로 표시됩니다. long은 진입이 초록색 위쪽 삼각형, 청산이 빨간색 아래쪽 삼각형이고, short는 방향이 반대입니다. P/L과 가격 변화는 청산 마커 위의 고정 텍스트가 아니라 마커 툴팁에 표시됩니다.
체결이 그려지는 방식: 각 체결은 개별적으로 표시됩니다. 매수는 초록색 B 마커, 매도는 빨간색 S 마커입니다. 거래소가 해당 필드를 제공하면 툴팁에 가격, 수량, P/L, 시간이 표시됩니다.
오픈 포지션과 지정가 오더가 그려지는 방식: 오픈 포지션은 진입 마커로 표시되고, 지정가 오더는 해당 토글이 켜져 있으면 차트에 가격 라인으로 표시됩니다.

핵심 화면 및 컨트롤

"거래소 계정" 다이얼로그: "개요", "연결", "설정" 탭 포함.
저장된 연결, 연결별 메시지, 새 연결 폼이 있는 "연결" 탭.
클릭 가능한 카드와 포지션, 오더, 체결, 잔고, 종료된 포지션 테이블이 있는 "개요" 탭.
기간 선택 및 진행 상태가 있는 히스토리 추가 로드 다이얼로그.
타임프레임 버튼, 히스토리 표시 모드, 오픈 포지션 토글, 지정가 오더 토글이 있는 "설정" 탭.
$ 버튼과 선택한 타임프레임의 트레이딩 마커가 있는 차트 패널.
차트의 종료된 포지션 마커: 진입 삼각형, 청산 삼각형, 점선, 툴팁.

단계별 시나리오

헤더의 "거래소 계정" 버튼을 여세요. 모바일에서는 컴팩트 메뉴에서 여세요.
아직 연결이 없다면 다이얼로그는 "연결" 탭으로 열립니다. 거래소를 선택하고 "추가"를 누르세요.
선택한 거래소가 요구하는 필드를 입력하세요. Binance USD-M의 경우 읽기 활성화, 출금 비활성화, USD-M Futures 데이터 읽기 가능 상태의 키를 생성하세요.
저장 전에 키를 확인하려면 "검증"을 누르세요. 검증 메시지는 폼 옆이나 특정 저장된 연결 옆에 표시되어 어떤 연결에 대한 것인지 바로 알 수 있습니다.
검증 후 "연결"을 누르세요. 키 시크릿은 서버에 암호화된 형태로 저장되며, UI에는 마스킹된 힌트만 표시됩니다.
저장된 연결 행에서 "검증", "연결 해제", "삭제", "히스토리" 버튼을 사용하세요. "히스토리"는 기간 선택 다이얼로그를 열며: 1일, 7일 또는 30일을 고를 수 있습니다.
"개요" 탭을 열고 데이터 카드를 클릭하세요: 오픈 포지션, 지정가 오더, 체결, 잔고, 종료된 오더, 종료된 포지션 중 하나를 눌러 테이블을 볼 수 있습니다.
"설정" 탭을 열고 트레이딩 데이터 표시용 타임프레임을 선택하세요. 종료된 히스토리 표시 방식은 "포지션" 또는 "체결"로 선택하고, 오픈 포지션과 지정가 오더를 그릴지 여부도 지정하세요.
선택한 타임프레임 중 하나의 차트로 이동하세요. 차트 패널의 $ 버튼으로 설정 다이얼로그로 돌아가지 않고도 트레이딩 마커를 빠르게 켜고 끌 수 있습니다.
데스크톱에서는 마커에 마우스를 올리고, 모바일에서는 탭해서 툴팁을 여세요. 자세한 값은 툴팁에 있고, 마커 자체는 컴팩트하게 유지됩니다.

스크린샷

거래소 계정 개요

연결된 거래소, 포지션 수, 오더 수, 체결 수, 잔고 수, 동기화 시간 요약.

저장된 연결

각 연결에는 거래소, 상태, 마스킹된 키, 개별 액션이 표시됩니다: 검증, 히스토리, 연결 해제, 삭제.

차트 마커 설정

타임프레임, 히스토리 표시 모드, 오픈 포지션, 지정가 오더는 차트의 빠른 $ 버튼과 별도로 설정됩니다.

종료된 포지션 테이블

개요의 카드를 클릭하면 계정 데이터 테이블이 열립니다: 포지션, 오더, 체결, 잔고, 종료 히스토리.

실전 메모

거래소 API 키는 계정의 민감한 프라이빗 데이터입니다. Watchlist.top 전용 키를 따로 만들고 출금 권한은 켜지 마세요.
앱은 read-only 접근만 요구하지만, 거래소마다 읽기 권한 명칭이 다릅니다. Binance는 먼저 Reading을 확인하고, 그다음 USD-M Futures 계정 데이터가 실제로 읽히는지도 별도로 확인합니다.
demo 모드에서는 API 키 연결을 사용할 수 없습니다. 다이얼로그는 열 수 있지만, 연결 추가는 해당 기능이 활성화된 계정 상태여야 가능합니다.
히스토리 추가 로드는 의도적으로 인터랙티브 계정 검증과 현재 데이터 업데이트보다 우선순위가 낮게 설정되어 있으므로, 심볼과 체결 수가 많은 계정에서는 시간이 걸릴 수 있습니다.
종료된 포지션은 사용 가능한 체결 및 오더 히스토리로 복원됩니다. 거래소가 해당 기간의 히스토리를 충분히 제공하지 않으면 오래된 포지션은 불완전할 수 있습니다.
$ 버튼은 자체적으로 표시 대상을 선택하지 않습니다. 타임프레임과 히스토리 모드를 설정한 뒤 차트 표시를 빠르게 켜고 끄는 역할만 합니다.
거래소 계정 -> 설정에서 타임프레임을 하나도 선택하지 않으면 $ 버튼은 숨겨지고, 차트의 트레이딩 마커는 비활성화됩니다.
마커가 보이지 않으면 심볼, 거래소, 시장 유형, 선택한 타임프레임, $ 버튼 상태, 필요한 토글이 켜져 있는지 확인하세요.
P/L은 거래소 데이터에서 전달되는 자산 단위로 표시됩니다. 예: USDT 또는 USDC. 수량은 항목에 따라 base 또는 quote 자산을 사용합니다.

사용할 때

거래소 API 키를 안전하게 연결하고 Watchlist.top이 어떤 데이터를 읽는지 이해해야 할 때 이 섹션을 사용하세요.
차트에 거래 마커가 보이지 않아 타임프레임, $ 버튼 또는 표시 모드를 확인해야 한다면 여세요.
계정 테이블을 보거나 더 오래된 거래 기록을 추가 로드해야 할 때 유용합니다.

이 기준에 의존하지 말아야 할 때

OI, funding 또는 오더북 불균형 같은 공개 시장 메트릭에는 이 섹션을 사용하지 마세요.
문제가 거래소 키 추가와 직접 관련되지 않았다면 결제, 구독 또는 이메일 확인에 관한 섹션이 아닙니다.

대표적인 해석 실수

$ 버튼은 켜고 거래소 계정 설정에서 타임프레임은 선택하지 않기.
저장된 API 키로 앱이 거래할 수 있다고 생각하기. 이 기능은 읽기 전용이며 출금 권한이 없는 키를 사용해야 합니다.
계정에 대해 거래 기록이 추가 로드되기 전에 오래된 종료 포지션이 보일 것이라고 기대하기.

이해해야 할 알고리즘과 공식

거래소별 read-only 검증 방식 차이와 Binance에서 USD-M Futures 계정 데이터 읽기 가능 여부를 추가로 확인하는 이유
백그라운드 동기화가 앱이 활성 상태일 때만 계정 데이터를 업데이트하고, 연결된 모든 계정을 무한정 폴링하지 않는 방식
히스토리 추가 로드가 거래소 요청 한도에 미치는 영향을 줄이기 위해 낮은 우선순위 큐에 들어가는 방식
거래소가 종료된 포지션이라는 별도 엔티티를 제공하지 않을 때, 종료된 포지션을 체결 및 오더 히스토리로 복원할 수 있는 방식
차트의 마커가 거래소, 선물 시장, 심볼, 선택한 타임프레임, 표시 설정 기준으로 필터링되는 방식
차트 패널의 $ 버튼이 상세 설정과 분리된 이유: 설정은 무엇을 그릴 수 있는지 정하고, 버튼은 표시 여부만 빠르게 켜고 끕니다.