거래소 API 연동
조회 전용 API 키를 등록하면 체결 내역이 자동으로 매매일지에 쌓입니다.
무엇을 하나요
거래소 계정에서 발급한 조회 전용(Read-Only) API 키를 등록하면, 체결 내역을 자동으로 가져와 평단·손익·최종총자산을 계산해 매매일지에 채워 넣습니다. CSV 파일을 내려받아 올리는 과정 없이 동기화 버튼 한 번이면 됩니다.
지원 거래소는 Bybit·MEXC·Bitget이며, 현물과 선물을 선택해서 가져올 수 있습니다. MEXC 선물은 준비 중입니다.
거래소 API 연동은 유료 플랜에서 사용할 수 있으며, 최대 5개까지 연동할 수 있습니다.
연동하기
- 위치 — 매매일지의 가져오기 화면에서 API 연동을 선택하거나, 설정 → API 연동 탭에서 관리합니다.
- 거래소 선택 후 키 입력 — API Key와 Secret을 입력합니다. Bitget은 발급 시 정한 Passphrase도 함께 입력합니다. 발급 방법은 화면 옆 가이드 패널에 거래소별로 안내됩니다.
- 조회 전용 키만 — 거래·출금 권한이 있는 키는 등록이 거부됩니다. 반드시 읽기 전용(Read-Only) 권한으로 발급하세요.
- 시작일(선택) — 이 날짜 이후의 체결만 가져옵니다. 비워 두면 거래소가 허용하는 가장 오래된 내역부터 가져옵니다.
- 귀속 지갑(선택)— 가져온 거래를 넣을 지갑을 고릅니다. 선택하지 않으면 "암호화폐" USD 지갑이 자동으로 만들어져 귀속됩니다.
- 지갑은 나중에 바꿀 수 있어요 — 연동 목록에서 각 연동에 표시된 지갑명을 누르면 드롭다운으로 다른 지갑을 고를 수 있습니다. 변경은 다음 동기화부터 적용되며, 이미 가져온 거래는 원래 지갑에 그대로 남습니다.
동기화
- 수동 동기화 — 연동 카드의 동기화 버튼을 누르면 새 체결을 가져옵니다. 연속 실행을 막기 위한 대기시간이 있으며 60초입니다.
- 이어받기 — 내역이 많으면 한 번에 일부만 가져오고, 잠시 후 다시 동기화하면 이어서 가져옵니다.
- 중복 제외 — 이미 가져온 체결은 자동으로 걸러져 두 번 저장되지 않습니다.
거래소별로 API가 제공하는 과거 조회 범위가 다릅니다.
| 거래소 | 조회 가능 기간 |
|---|---|
| Bybit | 최근 2년 |
| MEXC | 최근 30일 |
| Bitget | 최근 90일 |
그보다 오래된 내역은 거래소에서 CSV로 내려받아 CSV 가져오기로 채울 수 있습니다.
포지션이 계속 "진행 중"으로 남을 때
조회 가능 기간 이전에 진입한 포지션은 진입 체결이 빠진 채 청산 체결만 들어오는 등, 연동 초기에는 매수·매도 수량이 어긋날 수 있습니다. 수량이 어긋나 순포지션이 0이 되지 않으면 이미 청산을 끝낸 심볼도 계속 진행 중으로 남습니다.
실제로는 청산이 끝난 포지션이라면, 그 심볼의 마지막 매매일지를 열어 상태를 청산 완료로 바꿔 저장하세요. 수량이 남아 있다는 확인 창에서 확인을 누르면 남은 수량이 0으로 정리되고 진행 중 표시가 사라집니다. 이후 동기화부터는 새 체결이 정상적으로 쌓입니다.
보안과 해제
- 등록한 API 키는 암호화(AES-256-GCM)해서 저장되며, 화면에는 일부만 마스킹되어 표시됩니다.
- 키는 체결 내역 조회에만 사용되며, 거래·출금은 구조적으로 불가능합니다.
- 연동을 해제하면 보관 중인 키는 즉시 파기됩니다. 이미 가져온 매매일지는 그대로 유지됩니다.
플랜별 연동 개수와 요금은 요금제·결제를 참고하세요.