시작 전: 지갑 로그인과 읽기 전용 키가 필요합니다
API 키는 거래소가 외부 서비스에 계정 조회를 허용할 때 발급하는 인증 정보입니다. 차트매매는 USDT 무기한 선물의 체결·포지션·비용을 조회하는 데 사용합니다. 거래소 비밀번호나 지갑의 시드 문구·개인키를 입력하는 절차는 없습니다.
거래소 연결은 차트매매에 지갑으로 로그인한 뒤 내 공간에서 할 수 있습니다. 저장 없이 분석만 체험하려면 API 키 없이 거래 CSV를 내 매매 분석에 넣어보세요. 로그인 전에도 이 가이드를 읽을 수 있습니다.
- 준비할 값: Binance·Bybit는 API Key와 Secret Key, OKX는 여기에 API Passphrase가 추가됩니다.
- 조회할 실제 계정에서 전용 키를 만드세요. 본계정과 하위 계정의 키를 섞지 말고, 실거래용과 데모·테스트용을 구분하세요.
- USDT 무기한 선물 계정과 이용 자격이 준비되어 있는지 확인하세요. 계정 유형·지역·상품에 따라 조회 가능한 내역은 다를 수 있습니다.
- 권한은 Reading·Read-Only·Read만 사용하세요. 주문·거래·출금·이체 권한이 있는 키는 연결하지 않습니다.
IP 허용목록이 필요한 경우
거래소가 API 호출 IP를 제한하도록 요구한다면 차트매매 서버의 공식 허용 IP가 필요합니다. 현재 이 가이드에는 검증된 고정 서버 IP 목록이 제공되어 있지 않습니다. IP 제한이 필요한 키는 공식 목록이 안내될 때까지 연결을 보류하고 CSV 분석을 이용하세요.
사이트를 열 때 사용하는 도메인의 IP와 API 요청이 나가는 서버 IP는 다를 수 있습니다. 웹사이트 DNS의 A 레코드나 본인 PC·휴대폰의 IP를 대신 입력하지 마세요. IP 오류를 해결하려고 허용목록을 지우거나 보안 제한을 해제하지 마세요.
Binance: System-generated 키와 Enable Reading
바이낸스 공식 웹사이트에 로그인한 뒤 프로필 → Account → API Management → Create API로 이동합니다. 메뉴 이름은 언어에 따라 다를 수 있습니다. 계정 인증·2단계 인증 등 거래소가 요구하는 준비와 보안 확인을 먼저 완료하세요.
키 유형은 System-generated를 선택합니다. 차트매매의 API Key·Secret 입력 방식에 맞는 HMAC 키입니다. 이름은 ChartMaemae 조회 전용처럼 용도를 알아볼 수 있게 적고, 생성 후 API Key와 Secret Key를 안전하게 보관하세요.
권한은 Enable Reading으로 제한하세요. Enable Futures, 현물·마진 거래, 출금, 내부·범용 이체 등 거래·자금 이동 권한을 켜지 마세요. 선물 계정이 활성화되어 있어도 읽기 전용 키로 모든 계정 유형의 선물 내역을 조회할 수 있다고 보장되지는 않습니다. 연결 검증에서 거부되면 권한을 넓히지 말고 CSV 분석을 이용하세요.
Bybit: System-generated 키와 Read-Only
바이비트 공식 웹사이트에서 프로필 → API 또는 API Management로 이동한 뒤 Create New Key를 선택합니다. 공식 도움말은 웹사이트에서의 발급 절차를 안내합니다. 신규 계정은 발급 대기 제한이 있을 수 있으니 화면에 표시된 조건을 확인하세요.
System-generated API Key를 선택하고 이름을 적은 뒤 권한을 Read-Only로 설정합니다. 계약 조회 범위를 고르는 항목이 있다면 Contract의 Orders·Positions에 해당하는 조회 범위를 선택하세요. Read-Write나 출금·이체 권한으로 바꾸지 마세요.
거래소가 요구하는 2단계 인증을 마치고 API Key와 Secret Key를 보관합니다. 차트매매는 서버에서 Read-Only 여부를 다시 확인합니다. 이용 지역이나 계정 유형이 현재 연결 방식과 맞지 않으면 오류 안내를 확인하고 CSV 분석을 이용하세요.
OKX: Read 권한과 API Passphrase
OKX 공식 웹사이트에 로그인한 뒤 프로필 → API and connections → Create API key로 이동합니다. 키 이름, 조회할 계정과 사용 목적을 선택하고 필요한 IP 허용목록과 보안 확인을 진행합니다.
Permissions는 Read만 선택하세요. Trade에는 주문뿐 아니라 자금 이체 등 쓰기 동작도 포함되므로 선택하지 않습니다. Withdraw 역시 선택하지 않습니다. API Passphrase는 키를 만들면서 본인이 정하는 값이며, OKX 로그인 비밀번호와 구분해서 보관하세요.
생성이 끝나면 API Key·Secret Key·API Passphrase 세 값을 같은 키의 정보로 보관하세요. Passphrase는 분실 후 복구할 수 없으므로 잃어버렸다면 기존 키를 삭제하고 새로 발급해야 합니다. 계정과 지역에 맞는 공식 API 안내도 함께 확인하세요.
차트매매에 연결하고 상태를 확인합니다
chartmaemae.com의 내 공간에서 지갑 로그인 후 거래소 읽기 전용 연결로 이동합니다. 거래소와 계정 표시명을 고르고, 발급한 API Key·Secret을 각 입력란에 넣으세요. OKX를 선택했다면 API Passphrase도 입력합니다. 키는 로그인한 연결 폼에만 입력하고 AI 코치 대화·텔레그램 메시지·문의 내용에 붙여넣지 마세요.
연결 검증이 통과했는지 먼저 확인한 다음 동기화 상태와 마지막 갱신 시각을 살펴보세요. 요청이 접수되었다는 사실과 과거 내역 수집이 완료되었다는 사실은 다릅니다. 오류가 표시되면 계정·키 종류·읽기 권한·IP 조건을 확인하고, 해결하려고 거래 권한을 추가하지 마세요.
거래소 API는 조회 기간과 요청 범위에 제한이 있어 연결 직후 과거 전체 내역이 채워지지 않을 수 있습니다. 필요한 기간의 CSV를 거래소에서 내려받아 보완할 수 있습니다. 같은 거래소 계정의 내역을 합칠 때에는 계정 표시를 맞추고 수집 범위를 함께 확인하세요.
키 보관·연결 해제·기록 삭제를 구분합니다
Secret은 발급 직후 한 번만 표시될 수 있습니다. 값을 남겨야 한다면 본인이 관리하는 비밀번호 관리자에 보관하고, 잃어버린 값은 임의로 추측해 입력하지 말고 새 키를 발급하세요. 불필요한 키와 유출이 의심되는 키는 거래소 API 관리에서 폐기하세요.
차트매매의 연결 해제는 해당 키를 이용한 추가 수집을 중단하는 기능입니다. 이미 저장한 매매 기록 삭제와는 별도입니다. 저장 기록도 지우려면 내 공간의 관련 삭제 기능을 사용하고, 거래소의 키도 더 이상 필요 없다면 거래소에서 직접 삭제하세요.
거래소 공식 안내
2026년 10월 17일 공식 문서 확인 기준입니다. 메뉴와 발급 조건은 계정·지역에 따라 달라질 수 있으므로 거래소의 최신 안내를 함께 확인하세요.