More 메뉴, 이름, Generate / Authorize API Wallet, 유효 기간과 최종 Authorize 위치를 안내합니다. 개인 키 표시 영역과 주 지갑 서명 창은 제외했습니다.
단계 1
계정과 진입 경로 확인
공식 앱에서 실제 거래할 주 지갑을 연결하고 메인넷·대상 계정을 확인하세요. 처음이라면 공식 계정 활성화 요건을 확인합니다. 주 지갑 시드나 개인 키는 도구에 입력하지 마세요. More → API로 이동합니다.
그림 1More에서 API 열기
로그인 후 More 메뉴의 API를 찾으세요. 계정 연결은 공식 페이지에서 직접 완료합니다.
단계 2
전용 API 지갑 이름 지정
API 페이지에 arbitrage-tool 같은 용도 이름을 쓰고 Generate를 눌러 전용 주소를 만드세요.
그림 2공식 API 지갑 화면
이름, API Wallet Address, Generate, Authorize API Wallet 위치를 확인하세요.
지갑 미연결 상태의 빈 화면이며 생성·승인을 실행하지 않았습니다. 지역 제한 표시를 보존했으며 적용 여부는 공식 규칙을 따릅니다.
그림 3전용 API 지갑 이름
arbitrage-tool 등 용도를 나타내는 이름을 입력하세요.
CryptoCopy는 원본 안내의 이름 예시입니다. 해당 도구에 가입하거나 연결할 필요는 없습니다.
단계 3
승인 창 열기
Authorize API Wallet을 누르세요. 창을 여는 것만으로 최종 승인이 완료되지는 않습니다.
그림 4주소 생성 후 승인 창 열기
Generate 다음 Authorize API Wallet을 누르세요. 0x 값은 API 지갑 주소이며 개인 키나 주 계정 주소가 아닙니다.
예시 주소를 복사하지 마세요. 현재 SM FUND 주 계정 연결에는 주 주소가 필요하지 않습니다.
단계 4
개인 키 저장과 유효 기간 설정
유효 일수를 정하고 표시된 전용 개인 키를 신뢰할 수 있는 비밀번호 관리자나 암호화 저장소에 저장하세요. 해당 주소와 저장 완료를 확인한 후 진행합니다.
그림 5유효 기간과 최종 Authorize
전용 키를 저장하고 Days Valid를 설정한 다음 주 지갑으로 승인 서명합니다.
키 표시 영역은 제외했습니다. 180일 / MAX는 예시이며 공통 요건이 아닙니다. 현재 공식 선택지와 필요에 맞추세요.
단계 5
서명 후 승인 확인
공식 도메인, 기간, 승인 내용을 확인하고 창의 Authorize를 눌러 주 지갑에서 서명하세요. 목록에 유효한 대리인이 등록되어야 합니다. 주소 생성만으로는 완료되지 않습니다.
2단계: SM FUND에서 연결 항목 입력
설정에서 왼쪽의 미등록 Hyperliquid을 선택하거나 전체 거래소의 해당 행에서 추가를 누르세요.
계정 이름을 정하고 저장한 전용 자격 증명을 아래 표에 따라 붙여 넣으세요. 공백, 따옴표, 줄바꿈을 추가하거나 다른 세트의 키·시크릿·암호를 섞지 마세요.
입력 항목
입력 방법
계정 이름
차익거래 전용 등 구분하기 쉬운 이름
하위 계정 주소(주 계정은 비워 둠)
주 계정은 비워 두고 하위 계정은 실제 하위 계정 0x 주소 입력
API 지갑 개인 키
승인된 전용 API 지갑 개인 키. 주 지갑 키가 아님
자주 하는 입력 실수
주 계정은 하위 주소를 비우고 전용 API 지갑 개인 키만 입력하세요. 하위 계정은 실제 하위 0x 주소와 승인된 API 지갑 개인 키를 입력합니다. 주 지갑 주소 입력란은 없습니다.
처음 추가할 때는 교체 버튼보다 입력 항목을 확인하세요
아래 빈 교체 양식은 기존 계정의 자격 증명 항목을 확인하는 용도입니다. 처음 추가할 때는 계정 이름과 검증 후 저장을 사용합니다. 검증 후 교체는 동일 거래소 계정의 자격 증명 갱신에만 사용합니다.
그림 6 · SM FUND 연결 항목(빈 양식)
3단계: 검증·저장 후 조회 결과 확인
신뢰할 수 있는 배포 환경인지 확인하고 검증 후 저장을 누르세요.
자격 증명은 서버에 암호화되어 저장되며 다시 표시되지 않습니다. 저장 전에 안전하게 백업하세요.
계정 신원, 감지된 유형, 활성 상품, 비공개 계정 스트림과 마지막 동기화 시각을 확인하세요.
거래소의 동일 계정·시장과 잔액, 포지션, 미체결 주문을 대조하세요.
검증 실패나 로딩 지속 시 민감 정보를 가린 오류 코드, 시각, 대상 시장을 기록하세요.
먼저 자격 증명 세트, IP, 권한, 계정 환경을 확인하세요. 계정 반복 추가, 모든 권한 허용, 연결 시험용 주문은 하지 마세요.
Hyperliquid 연결 후 확인 사항
공식 화면의 동일 주·하위 계정, 동일 현물·무기한 시장과 잔액·포지션·주문을 비교하세요. 주 계정은 하위 계정 주소를 비워 두고, 하위 계정은 실제 주소를 입력합니다. API 지갑 주소가 아닙니다. 주 계정 감지 실패 시 민감 정보를 가린 오류를 보관해 문의하세요. 주 주소 입력란은 없습니다.
거래소 주의 사항
API 지갑은 대리 서명에 사용됩니다. nonce 충돌을 줄이려면 거래 프로세스마다 별도 API 지갑을 쓰세요. 취소·만료 후에는 새 대리인을 만들고 취소된 주소를 재사용하지 마세요.
연결 상세에는 표준 계정으로 표시됩니다. 교차·격리 등 모든 모드 지원이 검증되었다는 뜻은 아닙니다.
SM FUND 양식에는 출금을 제외한 거래 권한이 필요합니다. 필요한 조회 및 시장의 거래만 허용하고 출금은 끄세요. 공개 시세만 보려면 계정을 추가하지 않아도 됩니다.
1단계: 거래소에서 전용 자격 증명 생성
프로필 메뉴, Create API, 용도·이름·암호·IP 양식, 권한과 생성 후 목록을 안내합니다. 전체 자격 증명과 QR은 제외했습니다. 2FA는 공식 화면에서 진행하세요.
단계 1
API 생성 열기
실제 자금을 보유한 대상 계정에 로그인해 프로필 → API and connections → Create API로 이동하세요.
그림 1프로필에서 API 열기
오른쪽 위 프로필 → API. 새 버전은 API and connections일 수 있습니다.
그림 2Create API 클릭
APIs 페이지 오른쪽 위 + Create API를 찾으세요.
단계 2
용도·이름·API 암호 설정
Account와 Used for를 확인하세요. 이 안내는 Key / Secret 수동 입력 방식입니다. 다른 앱의 제3자 연결을 SM FUND 승인으로 혼동하지 마세요. 이 세트의 Passphrase를 정하고 저장합니다.
그림 3용도·이름·Passphrase·IP
수동 연결은 API trading을 고르고 API name, Passphrase, IP address allowlist에 실제 실행 출구 IP를 입력하세요.
참고 양식의 빈칸이나 optional이 허용 목록 생략 권장은 아닙니다. 화면 변경 시 공식 가이드를 따르세요.
단계 3
실행 서버 IP 등록
이 배포가 실제 API 요청을 보내는 고정 공인 출구 IP를 입력하세요. 모르면 운영자에게 확인하고 DNS 주소나 예시를 대신 쓰지 마세요.
단계 4
시장과 권한 확인
조회를 유지하고 필요한 현물·무기한 거래만 켜세요. 출금은 끄고 Transfer·Loan·Earn도 개별 확인합니다. Trade 선택만으로 점검을 끝내지 마세요.
그림 4Read·Trade·Withdraw
Read를 유지하고 필요한 Trade만 켜며 Withdraw는 선택하지 마세요.
새 Transfer / Loan / Earn은 이 그림에 없으므로 전체 양식에서 확인하세요.
그림 5거래 시장과 권한
필요한 시장의 조회·거래를 맞추고 출금은 끄세요.
예시는 현물·마진과 무기한을 함께 선택했지만 모두의 필수 사항은 아닙니다. Transfer·Loan·Earn도 확인합니다.
단계 5
검증 후 동일 세트 저장
공식 보안 인증을 완료하고 생성된 API Key·Secret Key·직접 정한 Passphrase를 한 세트로 안전하게 저장한 후 페이지를 닫으세요.
그림 6생성 후 이름·권한 확인
이름·용도·권한을 확인하고 본인의 공식 페이지에서 전체 Key / Secret을 저장하세요. 별표는 사용 가능한 키가 아닙니다.
Coinrule Trading API는 원본 계정의 이름 예시이며 Coinrule 연결은 필요 없습니다. 전체 키는 표시되지 않습니다.
2단계: SM FUND에서 연결 항목 입력
설정에서 왼쪽의 미등록 OKX을 선택하거나 전체 거래소의 해당 행에서 추가를 누르세요.
계정 이름을 정하고 저장한 전용 자격 증명을 아래 표에 따라 붙여 넣으세요. 공백, 따옴표, 줄바꿈을 추가하거나 다른 세트의 키·시크릿·암호를 섞지 마세요.
입력 항목
입력 방법
계정 이름
차익거래 전용 등 구분하기 쉬운 이름
API 키
거래소에서 생성한 API 키. UID가 아님
API 시크릿
위 키와 동일 세트의 시크릿
Passphrase
이 키 세트를 만들 때 정한 API 암호
자주 하는 입력 실수
동일 API 세트의 Key·Secret과 생성 시 정한 Passphrase를 입력합니다. 로그인 비밀번호가 아닙니다.
처음 추가할 때는 교체 버튼보다 입력 항목을 확인하세요
아래 빈 교체 양식은 기존 계정의 자격 증명 항목을 확인하는 용도입니다. 처음 추가할 때는 계정 이름과 검증 후 저장을 사용합니다. 검증 후 교체는 동일 거래소 계정의 자격 증명 갱신에만 사용합니다.
그림 7 · SM FUND 연결 항목(빈 양식)
3단계: 검증·저장 후 조회 결과 확인
신뢰할 수 있는 배포 환경인지 확인하고 검증 후 저장을 누르세요.
자격 증명은 서버에 암호화되어 저장되며 다시 표시되지 않습니다. 저장 전에 안전하게 백업하세요.
계정 신원, 감지된 유형, 활성 상품, 비공개 계정 스트림과 마지막 동기화 시각을 확인하세요.
거래소의 동일 계정·시장과 잔액, 포지션, 미체결 주문을 대조하세요.
검증 실패나 로딩 지속 시 민감 정보를 가린 오류 코드, 시각, 대상 시장을 기록하세요.
먼저 자격 증명 세트, IP, 권한, 계정 환경을 확인하세요. 계정 반복 추가, 모든 권한 허용, 연결 시험용 주문은 하지 마세요.
OKX 연결 후 확인 사항
주·하위 계정과 유형을 확인하고 현물·무기한별 잔액·포지션·주문을 대조하세요. 암호 오류는 같은 API 세트의 Passphrase를 확인합니다. 모드 불일치는 오류를 남겨 호환성을 조사하며 바로 모드를 바꾸지 않습니다.
거래소 주의 사항
Read·Trade·Withdraw 외에 Transfer·Loan·Earn도 확인하세요. 공식 FAQ는 일부 기존 Trade 키가 권한 변경 후 앞의 세 항목도 자동 활성화될 수 있다고 설명합니다. 출금 비활성화만 보지 말고 실제 권한을 점검하세요. Passphrase 분실 시 키를 재생성해야 합니다.
연결 상세에는 표준 계정으로 표시됩니다. 실제 모드는 검증 시 읽으며 별도 증거금 모드 선택란은 없습니다.
Pro API 승인, 이름·Generate, 안전한 IP·Authorize 영역을 안내합니다. 권한·기간은 가린 참고 이미지이며 주 지갑 서명 창이나 승인 결과 목록 실습 이미지는 없습니다.
단계 1
메인넷 API 지갑과 Pro API
공식 앱에 실제 거래 주 지갑을 연결하고 대상 계정·공식 활성화 요건을 확인하세요. V3 API 지갑을 사용합니다.
그림 1Pro API → Authorize new API wallet
Pro API에서 Authorize new API wallet을 찾으세요.
공개 안내의 지갑 연결 화면입니다. 이 안내 작성 중 연결·승인·계정 변경은 하지 않았습니다.
단계 2
전용 키 생성·저장
Authorize new API wallet에서 전용 주소를 만들고 표시된 개인 키를 안전하게 저장하세요. 주 지갑 키·시드를 사용하지 마세요.
그림 2이름과 Generate 안전 영역
전용 이름과 Generate를 사용하세요. 개인 키 표시 영역은 제외했습니다.
0x는 API 지갑 예시입니다. 복사하거나 주 지갑 키를 쓰지 마세요.
그림 3생성·권한·유효 기간
전용 키를 저장하고 필요한 현물·무기한 권한으로 승인하세요.
주소·키는 원본에서 가렸습니다. 예시 기간·두 시장 선택은 필수가 아니며 출금은 끕니다.
단계 3
권한·유효 기간·IP 확인
필요한 현물·무기한만 허용하고 출금은 끄세요. 지원되는 기간·IP 제한을 필요에 맞춰 설정하며 실제 출구 IP를 씁니다. 예시 기간과 두 시장 선택은 필수가 아닙니다.
그림 4IP restrictions와 Authorize
IP 제한을 설정하고 전용 키 저장 후 주 지갑으로 승인하세요.
전체 개인 키는 제외했습니다. 새 권한 세부 사항은 앞의 그림과 현재 공식 화면을 따르세요.
단계 4
서명 후 유효 승인 확인
키 저장, 공식 도메인과 서명 내용을 확인해 주 지갑으로 승인하세요. 목록에서 유효 기간 내 승인을 확인합니다. 키 생성만으로 승인 완료는 아닙니다.
2단계: SM FUND에서 연결 항목 입력
설정에서 왼쪽의 미등록 Aster을 선택하거나 전체 거래소의 해당 행에서 추가를 누르세요.
계정 이름을 정하고 저장한 전용 자격 증명을 아래 표에 따라 붙여 넣으세요. 공백, 따옴표, 줄바꿈을 추가하거나 다른 세트의 키·시크릿·암호를 섞지 마세요.
입력 항목
입력 방법
계정 이름
차익거래 전용 등 구분하기 쉬운 이름
API 지갑 개인 키
승인된 전용 API 지갑 개인 키. 주 지갑 키가 아님
자주 하는 입력 실수
승인된 전용 API 지갑 개인 키만 입력하세요. user / signer 입력란은 없습니다. 구형 Key / Secret 배포는 먼저 V3 호환성을 확인하세요. 감지 실패 시 오류를 가려 문의하고 주 지갑 개인 키를 쓰지 마세요.
그림 5 · SM FUND 연결 항목(빈 양식)
3단계: 검증·저장 후 조회 결과 확인
신뢰할 수 있는 배포 환경인지 확인하고 검증 후 저장을 누르세요.
자격 증명은 서버에 암호화되어 저장되며 다시 표시되지 않습니다. 저장 전에 안전하게 백업하세요.
계정 신원, 감지된 유형, 활성 상품, 비공개 계정 스트림과 마지막 동기화 시각을 확인하세요.
거래소의 동일 계정·시장과 잔액, 포지션, 미체결 주문을 대조하세요.
검증 실패나 로딩 지속 시 민감 정보를 가린 오류 코드, 시각, 대상 시장을 기록하세요.
먼저 자격 증명 세트, IP, 권한, 계정 환경을 확인하세요. 계정 반복 추가, 모든 권한 허용, 연결 시험용 주문은 하지 마세요.
Aster 연결 후 확인 사항
예정된 주 계정에 승인된 유효 API 지갑인지 확인하고 공식 현물·계약 잔액·포지션·주문·시각을 대조하세요. user / signer 입력란은 없습니다. 감지 실패는 민감 정보를 가린 오류를 남기세요. -5050은 공식 입금 요건을 확인해 직접 판단하며 주 지갑 키로 대체하지 마세요.
거래소 주의 사항
공식 권장 신규 연결은 V3입니다. 2026-03-25부터 V1 신규 키 생성은 지원하지 않으며 기존 키와 V3 API 지갑은 다른 자격 증명입니다. 이 안내는 입금을 대신 실행하지 않습니다. 2026-09-01부터 관련 V3 비공개 계정·거래 API에는 연결 주 지갑의 입금 완료 요건이 있습니다. -5050은 이 요건을 확인하며 키 재생성을 반복하지 마세요.
검증 후 감지합니다. 주 계정 user 또는 대리 signer 주소 입력란은 없습니다.
거래 전에 조회 결과 확인
연결 완료 확인 방법
확인 위치
통과 기준
문제 발생 시 첫 조치
계정 유형과 이름
대상 계정과 환경이 맞고 주·하위 계정 혼동 없음
자격 증명 출처 확인. 다른 계정 키로 임시 대체 금지
비공개 계정 스트림 / 마지막 동기화
상태와 최근 동기화 시각 확인 가능
미연결·오류·계속 로딩은 조회 성공이 아님
잔액·포지션·미체결 주문
거래소의 동일 계정·시장·통화 기준과 일치
총자산과 사용 가능 잔액은 다름. 빈 데이터와 조회 실패 구분
상품 / 거래 허용
필요하며 해당 계정에서 실제 활성화된 상품만
시세 전용 상품은 거래 레그로 사용 불가. 무작정 권한 추가 금지
실행 상태
연결 확인을 위한 주문·전략 시작 없음
원격 인스턴스·전략 스위치·거래소 미체결 주문 확인
서로 다른 세 스위치
계정 활성화는 동기화, 상품 거래 허용은 거래 레그 사용, 스프레드 전략 활성화는 규칙에 따른 자동 실행을 제어합니다. 계정 연결 성공이 실제 거래 중이거나 두 레그 실행 검증 완료를 의미하지는 않습니다.
실거래 전 재확인
A/B 계정, 상품, 원래 종목 코드, 방향, 수량 단위.
양쪽 계약 승수, 단위 간격, 최소 명목 금액, 체결 가능 호가 깊이.
배치 금액, 규모 한도, 증거금, 수수료, 펀딩비, 청산 비용.
한쪽 실패·시간 초과·부분 체결 시 신규 작업 중단, 주문 조회 및 노출 처리 방법.
규칙보다 방향부터 확인
A는 매수 레그, B는 매도 레그
스프레드 추가 화면 일부
A · 매수 레그
진입 시 매수
계정, 시장, 원래 종목을 선택하세요. 일반 현물 매도에는 보유 수량 또는 별도로 검증된 차입 경로가 필요합니다.
B · 매도 레그
진입 시 매도
레그 교환은 A/B를 바꿉니다. 다른 거래소·상품·자산으로 구성할 수 있지만 서로 다른 자산은 완전한 헤지가 아닙니다.
관심 목록에서 규칙 설정까지
+ 스프레드 추가에서 A와 B를 고르고 계정·상품·원래 종목을 확인하세요.
관심 목록 추가와 추가 후 규칙 설정은 다른 작업입니다. 관심 목록 생성이 거래 검증 완료를 뜻하지 않습니다.
카드 이름을 눌러 상세 화면을 여세요. 호가는 A 매수 / B 매도로 표시되며 전략 편집에서 규칙을 봅니다.
진입·청산 기준값 전에 차액 / 비율과 단위를 확인하세요. 비율 모드의 회귀 비율은 기준에 영향을 주므로 다른 기준의 수치를 복사하지 마세요.
작업 또는 설정
화면상 의미
주의 사항
전략 활성화
규칙에 따른 자동 거래
실제 주문 가능. 연결 시험용 활성화 금지
단일 라운드
진입과 청산 한 라운드 완료 후 중지
여러 배치일 수 있음. 단일 주문이 아님
한도까지 진입
카드에서 규모 한도까지 수동 진입
최소 시험 주문이 아님
포지션 정리
해당 스프레드 포지션을 정리하는 거래
실제 체결과 잔여 포지션 확인
진입 금지 / 신호 청산 금지
진입 금지는 신규 진입, 청산 금지는 신호 청산 중지
신호 청산 금지 중에도 손절·강제 위험 축소 유효
규모 한도 / 배치 금액
큰 레그의 명목 한도 / 배치별 금액 범위
한도는 진입만 제한. 양쪽 거래소 최소 금액 충족 필요
선행 레그 선호
자동 / A 먼저 / B 먼저
두 레그의 동시 전량 체결은 보장되지 않음
전체 청산 후 초기화
설정의 전체 계정 정리 작업
재연결이나 알림 지우기 용도로 사용 금지
중지·취소·청산은 서로 다른 작업
규칙 중지는 기존 주문 취소나 포지션·대출 청산이 아닙니다. 페이지를 닫아도 원격 서비스는 멈추지 않습니다. 재개 전에 거래소에서 포지션·주문·부채를 확인하세요.
필요할 때 찾아보기
자주 하는 질문 55개
질문 55개
연결과 보안
API가 연결되면 바로 차익거래해도 되나요?
먼저 비공개 스트림, 유형, 상품 스위치, 잔액·포지션·주문을 확인하세요. 다음으로 A 매수 / B 매도, 수량 단위, 최소 금액, 규모·배치 한도를 점검합니다. 계정·관심 목록 추가는 거래 검증이 아닙니다. 전략 활성화나 수동 진입은 실제 주문을 만들 수 있습니다.
시세는 보이는데 잔액 조회가 실패하는 이유는?
공개 시세에는 보통 비공개 권한이 필요 없습니다. 오류 코드, 자격 증명 세트, 암호, IP, 시계, 사이트, 메인넷·테스트넷, 자금 계정을 확인하세요. 시세 성공으로 개인 인증을 증명할 수 없습니다.
출금 권한을 켜야 하나요?
아니요. 출금을 제외한 거래 권한이 필요합니다. 출금은 끄고 다른 자금 권한도 개별 검토하세요. 출금을 꺼도 거래 권한 악용에 따른 손실 위험은 남습니다.
IP 허용 목록에 PC와 서버 중 무엇을 넣나요?
실제로 거래소에 요청을 보내는 공인 출구 IP입니다. 운영자에게 고정 API 출구를 확인하고 자체 배포는 서버·프록시·경로를 점검하세요. DNS·집 IP·192.168.x.x 등 내부 주소로 대체하지 마세요. 출구 변경 후 재확인하며 제한 해제로 해결하지 않습니다.
API 화면을 지원팀에 보내도 되나요?
민감 정보를 가린 권한 화면, 오류 코드, 시각만 보내세요. 키·시크릿·암호·API 개인 키·QR·민감 계정 정보를 가려야 합니다. 지원팀은 전체 키나 시드가 필요하지 않습니다.
API 유출이나 도난이 의심되면?
전략을 중지하고 공식 페이지에서 키·대리 승인을 취소한 뒤 포지션·미체결 주문·자산 내역을 확인하세요. 취소가 기존 주문 취소나 자동 청산을 뜻하지는 않습니다. 공식 화면에서 잔여 노출을 처리하고 전용 키를 재생성해 권한을 점검하세요. 도구 비밀번호만 바꾸면 부족합니다.
CORS·451·시간 초과는 API 고장인가요?
브라우저 교차 출처, 지역 제한, 네트워크 경로를 각각 조사하세요. CORS는 서명 실패가 아니며 451은 키 반복 재생성으로 해결되지 않습니다. 지원되는 안전한 연결을 사용하고 브라우저 보안을 끄지 마세요.
기존 키가 갑자기 무효가 되면?
만료, IP 변경, 권한, 주·하위 계정 전환, 공식 공지를 확인하세요. 자동 실행을 멈추고 가린 오류를 보관합니다. 복구 후 기존 주문부터 조회해 재시작 중 중복 주문을 막으세요.
읽기 전용·읽기 쓰기·API 지갑 차이는?
읽기 전용은 보통 주문할 수 없고 읽기·쓰기는 허용 모듈을 조작합니다. API 지갑은 대리 서명이므로 읽기 전용이라 가정하지 마세요. 양식은 출금 없는 거래 권한이 필요합니다. 시세만 보면 계정이 필요 없고 조회 전용 키가 검증 후 저장을 통과한다고 보장하지 않습니다.
Secret이나 API 개인 키 저장을 잊었다면?
예시 값이나 주 지갑 개인 키를 쓰지 마세요. 공식 재조회 가능 여부를 확인하고 불가하면 새 키·대리인을 만들어 불필요한 기존 승인을 취소합니다. 새 정보를 저장해 도구를 갱신하고 조회부터 확인하세요.
API는 어디에 입력하며 저장됨이면 완료인가요?
설정의 미등록 거래소 또는 전체 거래소의 추가에서 계정 이름과 안내 항목을 쓰고 검증 후 저장을 확인하세요. 저장뿐 아니라 스트림·최근 시각·유형·상품·실제 잔액·포지션·주문을 계속 점검해야 합니다.
계정이 비어 있으면 주문으로 시험해도 되나요?
실주문으로 연결을 추측하지 마세요. 새 계정은 정말 비어 있을 수 있으니 조회 성공 시각·신원을 확인합니다. 오류·로딩·빈 결과는 다릅니다. Hyperliquid 주 계정의 하위 주소는 비우세요. Aster는 승인·V3·공식 입금 요건을 확인하며 없는 주소 입력란을 찾지 마세요.
타임스탬프·서명·nonce 오류는?
실행 서버 자동 시간 동기화, 동일 세트의 자격 증명·암호·환경·API 버전을 확인하세요. nonce는 서명 재사용 방지 번호로 대리 지갑을 여러 프로세스가 공유하면 충돌할 수 있습니다. 중복 실행을 멈추고 기술 지원에 문의하며 주문을 반복 전송하지 마세요.
PC·서버 변경이나 브라우저 복원 후에는?
자격 증명은 브라우저뿐 아니라 서버에 암호화 저장됩니다. 새 PC는 동일한 신뢰 배포인지 확인하고 새 서버는 출구 IP·동기화·기존 서비스 실행을 점검하세요. 기존 주문·포지션을 조회해 두 서비스 중복 실행을 막으세요. 암호화 구현과 서버 보안은 본 안내에서 감사하지 않았습니다.
차익거래 기초
S-S·S-F·F-F는 무엇인가요?
현물/현물, 현물/선물, 선물/선물입니다. 실제 자산·수량·표시 단위를 맞춰야 하며 이름이 비슷하다고 같은 자산은 아닙니다. F-F는 먼저 관찰하고 완전히 검증한 뒤 실행을 판단하세요.
A와 B 레그의 방향은?
스프레드 추가에서 A는 매수, B는 매도이며 레그 교환으로 바뀝니다. 상세도 A 매수 / B 매도를 표시합니다. +A-B / -A+B 버튼 방식은 아닙니다. 진입 전 계정·상품·원래 종목을 확인하고 청산은 실제 포지션을 반대로 줄입니다.
양의 스프레드인데 손실이 나는 이유는?
표시는 최근 체결가 기준일 수 있어 실제 체결 깊이를 반영하지 않을 수 있습니다. 양쪽 진입·청산 수수료, 슬리피지, 펀딩비, 이자, 이체·온체인 비용과 청산 시 가격 차이를 포함하세요.
최근 가격·매수 호가·매도 호가 중 무엇을 보나요?
A 매수는 A 매도 호가, B 매도는 B 매수 호가를 보세요. 주문량에 필요한 호가 깊이의 평균 체결가를 계산합니다. 최우선 호가만 봐도 슬리피지를 과소평가할 수 있습니다.
진입 스프레드는 어떻게 계산하나요?
차액 / 비율과 단위를 먼저 확인하세요. 비율은 A/B이며 회귀 비율 설정 후 목표 대비 편차가 기준입니다. 아래 예시는 가격·비용 이해용이며 제품 공식의 확정이 아닙니다. 다른 기준의 수치를 옮기지 마세요.
양의 펀딩비는 누가 내나요?
일반 무기한 규칙은 롱이 숏에게 내고 음수는 반대지만 해당 계약의 공식 규칙이 우선합니다. 각 레그를 별도 계산하며 한쪽 요율을 전체 수익으로 보지 마세요.
펀딩비가 높으면 진입할 만한가요?
정산 시각, 해당 시각을 넘겨 보유하는지, 예측값 여부, 상한과 가격 위험을 확인하세요. 정산 전 요율이 바뀔 수 있고 연율은 원금·수익 보장이 아닙니다.
거래소별 펀딩비를 바로 비교할 수 있나요?
정산 주기·부호·관찰 시각을 맞추고 같은 보유 기간의 실제 양쪽 지급액을 계산하세요. 시간당과 8시간당 요율을 그대로 비교하지 마세요.
양쪽 100 USDT면 완전 헤지인가요?
반드시 그렇지는 않습니다. 승수, 선형·역선형 계약, 체결가, 부분 체결에 따른 실제 자산 노출을 맞춰야 합니다. 먼저 같은 기초 자산의 실제 수량으로 환산하세요.
현물 매도 전에 코인이 필요한가요?
일반 현물 매도는 보유 수량이 필요합니다. 없다고 자동 공매도가 되지 않습니다. 차입 매도는 마진 계정·대출 한도·이자·상환 경로를 따로 검증하세요. S-S는 보통 매수 측 결제 통화, 매도 측 기초 자산 또는 검증된 자금 경로가 필요합니다.
동명 코인·1000배 계약·주식 토큰을 바로 조합하나요?
이름만으로 판단하지 마세요. 기초 자산·토큰 주소·매핑·승수·시간·결제 통화·선형 여부를 확인하세요. 1000배 계약은 단위 환산이 필요하고 주식 토큰·지수·무기한은 권리와 가격 체계가 달라 완전 헤지를 가정할 수 없습니다.
증거금 모드·포지션 모드·레버리지는 같은가요?
다릅니다. 증거금은 위험을 공유하는 자금, 포지션 모드는 순포지션 또는 롱·숏 동시 보유, 레버리지는 필요 증거금과 위험에 영향을 줍니다. 각각 확인하세요. 단방향도 숏이 가능하며 교차·고레버리지 변경은 연결 복구의 만능 해법이 아닙니다.
주문과 오류
기준값에 도달했는데 주문이 없는 이유는?
실행 활성화, 방향, 시세 최신성, 깊이, 잔액·증거금, 최소 수량, 호출 제한, 위험 차단을 순서대로 확인하세요. 발생 시각·호가·차단 사유를 기록합니다.
주문 요청 성공이 체결 성공인가요?
아니요. 접수·미체결·부분 체결·전량 체결·취소·거절을 공식 기록으로 구분하세요. 양쪽 접수 성공도 헤지 완료를 뜻하지 않습니다.
한쪽만 체결되고 다른 쪽은 실패하면?
루프와 신규 주문을 중지하고 양쪽 실제 주문 상태·누적 체결·포지션을 조회하세요. 노출을 파악한 뒤 사전 한도·손절 계획에 따라 보완 또는 종료합니다. 원래 주문을 무작정 재전송하지 마세요.
시간 초과 후 바로 재시도해도 되나요?
쓰기 요청을 곧바로 재전송하지 마세요. 거래소가 이미 접수했을 수 있습니다. 주문 ID나 클라이언트 주문 ID로 상태를 조회한 다음 결정하세요.
최소 수량·NOTIONAL·정밀도 오류는?
최소 자산 수량·명목 금액, 수량·가격 단위와 계약 단위를 양쪽 모두 확인하세요. 오류 우회만을 위해 금액을 크게 늘리지 마세요.
시장가 주문은 반드시 체결되나요?
아니요. 보호 장치, 가격 제한, 깊이, IOC 규칙으로 거절·부분 체결될 수 있고 가격도 미끄러집니다. 시장 규칙과 실행 후 노출을 확인하세요.
청산했는데 새 포지션이 생기는 이유는?
청산 방향·모드·positionSide / posSide·reduceOnly·실제 포지션을 확인하세요. API마다 요건이 다릅니다. 제품 청산 절차를 사용해도 잔여 포지션을 확인해야 합니다.
잔액은 많은데 자금 부족인 이유는?
총자산·가용 잔액·가용 증거금은 다릅니다. 자금·거래 계정, 하위 계정, 주문·증거금 점유와 대출을 점검하세요. 다른 계정의 돈이 자동으로 증거금이 되지는 않습니다.
여러 도구가 같은 계정을 거래해도 되나요?
포지션 변동·취소 충돌·중복 주문 위험이 커집니다. 별도 하위 계정을 권장합니다. Hyperliquid 같은 대리 서명은 프로세스별 대리인을 나눠 nonce 충돌도 방지하세요.
429·호출 제한·점검 안내는?
연속 새로고침·재시도를 중단하고 코드·시각을 기록하세요. 공식 제한에 따라 대기하거나 요청 빈도를 줄입니다. 점검 중 신규 노출을 막고 미확정 주문은 조회한 후 재전송을 결정하세요. 대기 시간은 거래소 응답을 따릅니다.
스프레드 정지나 네트워크 단절 시 거래해도 되나요?
최근 갱신·네트워크·공식 시세를 확인하세요. 데이터가 오래되거나 상태가 불명이면 신규 실행을 멈추고 공식 포지션·주문을 봅니다. 브라우저 끊김이 서버 전략 중단을 뜻하지 않습니다. 복구 후 기존 거래를 먼저 확인하세요.
일상 운영
단일 라운드는 단일 주문인가요?
아니요. 한 번의 진입·청산 완료 후 중지하며 여러 배치일 수 있습니다. 다른 도구의 Once와 같지 않습니다. 전략은 자동 거래하므로 소액 규모·배치 한도·예외 종료 계획을 먼저 정한 뒤 실행을 결정하세요.
헤지했는데도 강제 청산되는 이유는?
거래소별 증거금은 독립적이며 한쪽 이익이 다른 쪽에 자동 보충되지 않습니다. 변동·표시 가격 차이·유지 증거금 변경으로 한쪽 청산이 생깁니다. 각 레그 증거금과 청산 거리를 살피세요.
언제 종료해야 하나요?
진입 전에 순이익 목표·최대 손실·보유 시간·펀딩 반전·증거금·유동성·시스템 장애 종료 조건을 정하세요. 종료 후 양쪽 포지션·주문·차입·최종 명세를 확인합니다.
매일 운영 전 확인할 것은?
API 유효 기간·권한, 시세 시각, 미체결, 양쪽 포지션, 가용 증거금, 펀딩 정산, 차입, 점검, 네트워크를 확인하세요. 원인 불명 상태에서 규모를 늘리지 마세요.
실제 순이익은 어떻게 계산하나요?
실현 손익이 비용 전이면 양쪽 총손익 + 받은 펀딩비 − 낸 펀딩비 − 진입·청산 수수료 − 차입 이자 − 이체 비용입니다. 거래소 순손익에 이미 포함된 비용은 중복 차감하지 마세요. 미실현 손익은 분리하며 이체는 이익이 아닙니다.
지원팀에 어떤 정보를 보내나요?
거래소·시장·모드·시각과 시간대·가린 주문 ID·오류 코드·예상 결과와 실제 결과를 보내세요. 부분 체결은 양쪽 누적 체결량도 필요합니다. 전체 자격 증명은 보내지 마세요.
중지·페이지 종료·API 취소는 자동 청산인가요?
그렇게 가정하면 안 됩니다. 트리거 중단·주문 취소·포지션 청산은 별도이고 원격 서비스는 창을 닫아도 실행될 수 있습니다. 트리거·잔여 주문·포지션·대출을 각각 확인하며 API 취소 후 공식 화면에서 처리해야 할 수 있습니다.
현물 마진 청산 후 확인할 것은?
차입 원금·이자·자동 상환 결과를 확인하세요. 체결 완료가 부채 상환 완료는 아닙니다. 잔여 부채는 공식 규칙에 따라 상환·확인하며 두 레그 0만으로 라운드 종료라 보지 마세요.
곧바로 재시작하거나 규모를 늘리면 안 되는 경우는?
한쪽 미처리, 주문 상태 불명, 오래된 가격, 증거금 부족, 키 유출 의심, 불명확한 모드, 복구 중 중복 실행 위험이 있을 때입니다. 신규 작업을 멈추고 노출·주문·부채를 대조한 뒤 기존 한도에서 재개하세요.
제품 조작
계정 활성화·거래 허용·전략 활성화 차이는?
계정 활성화는 전체 시장 동기화, 상품 거래 허용은 레그 사용 가능 여부, 전략 활성화는 자동 규칙 실행입니다. 앞의 둘은 진입 버튼이나 청산 대체 수단이 아닙니다. 기존 포지션·주문 영향을 이해하고 바꾸세요.
한도까지 진입과 포지션 정리는?
전자는 전략 규모 한도까지 수동 진입하며 최소 시험 주문이 아닙니다. 후자는 해당 스프레드를 정리하는 거래입니다. 연결 시험에 쓰지 마세요. 이 안내는 표시명만 확인했고 체결 세부·확인 절차는 실거래 검증하지 않았습니다.
진입 금지·청산 금지·중지 차이는?
진입 금지는 신규 진입만 막고 청산은 계속합니다. 신호 청산 금지 중에도 손절·위험 강제 축소는 유효합니다. 중지·전략 활성화는 자동 실행을 제어하고 중지 중 축소 전용은 적용되지 않습니다. 어떤 상태도 기존 주문 취소를 보장하지 않습니다.
배치 금액·규모 한도·최소 금액 관계는?
규모 한도는 더 큰 레그의 명목 가치로 신규 진입만 제한합니다. 배치 범위는 깊이·최소 금액을 반영합니다. 최소 금액이 배치 상한이나 남은 규모를 넘으면 반복 클릭하지 말고 양쪽 환산·최소 수량·위험 예산을 다시 확인하세요.
재검증·교체·계정 제거 차이는?
재검증은 유형·권한·상품을 다시 읽습니다. 교체는 동일 계정임을 검증해 바꾸며 실패 시 기존 키를 유지합니다. 제거 후 시세만 보며 주문·체결 이력은 남습니다. 제거가 거래소 API 취소나 청산은 아닙니다.
전체 청산 후 초기화를 연결 복구에 쓰나요?
안 됩니다. 위험 작업이며 자동 주문 중단 후 거래소별 주문·포지션·잔액을 정리하고 성공 시 거래 상태를 초기화합니다. 전체 계정 체계에 영향이 있으므로 재연결이나 개별 오류 주문 조회 대용이 아닙니다.
차트 점선은 체결 가능한 스프레드인가요?
아니요. 로컬 데이터가 없으면 거래소 체결가로 추정하며 점선은 체결 불가 표시입니다. 진입·청산은 현재 호가·시각·해당 지표를 보고 판단하며 과거 추정선을 실행 가능 호가로 여기지 마세요.
두 레그 동시 전량 체결이 보장되나요?
아니요. 선행 레그는 자동·A 먼저·B 먼저이므로 실행 순서가 있습니다. 한쪽 접수가 다른 쪽 체결은 아닙니다. 실제 체결·잔여 주문·순노출을 확인하고 연결·레그 이상 시 신규 작업을 멈추세요.
시세는 보이는데 거래 레그로 고를 수 없는 이유는?
계정 미등록이거나 상품이 시세 전용이면 거래 레그로 사용할 수 없습니다. 계정 검증·동기화 활성화·상품 거래 허용을 확인하세요. 시세 연결을 주문 권한과 혼동하지 마세요.
모든 수치는 가정입니다
스프레드·펀딩비·계약 수량 계산
계산 방식 설명용이며 현재 시세, 실제 요율, 진입 권유가 아닙니다.
예시 1: 진입 스프레드는 이익이 아닙니다
A를 100 USDT에 사고 B를 100.20 USDT에 1단위 팔면 진입 차이는 0.20 USDT(0.20%)입니다. 청산 시 양쪽 실제 가격이 같고 네 거래 수수료가 0.24 USDT라면 다른 비용을 제외해도 0.04 USDT 손실입니다. 실제 순이익에는 최종 청산가도 포함해야 합니다.
예시 2: 양쪽 펀딩비를 별도 계산
같은 정산 시각·양쪽 명목 1,000 USDT이고 양수면 롱이 숏에게 낸다고 가정합니다. A 롱 +0.01%는 0.10 USDT를 내고 B 숏 +0.03%는 0.30 USDT를 받아 순펀딩은 0.20 USDT입니다. 거래 비용·가격 손익 전 수치이며 정산 시각을 넘겨 보유하지 않았다면 수익에 넣지 마세요.
예시 3: 계약 수량을 먼저 환산
선형 계약 하나가 0.001 BTC라면 10계약은 0.01 BTC입니다. 현물 0.01 BTC와 맞추는 기준은 실제 자산 수량이며 양쪽에 10을 입력하는 것이 아닙니다. 시장별 승수·단위·최소 명목 금액을 조회하세요. 모든 역선형·특수 계약에 해당하는 예시는 아닙니다.
항목 빠른 참조
자격 증명과 거래 용어 이해
용어
의미
혼동 주의
API Key / API Secret
API 요청 식별·인증용 전용 자격 증명
UID·로그인 비밀번호·자금 비밀번호가 아님
Passphrase
OKX / Bitget API 생성 시 직접 정한 API 암호
로그인 비밀번호가 아님. 분실 시 공식 절차로 재생성
API 지갑 개인 키
전용 에이전트 서명 자격 증명
주 지갑 개인 키·시드 문구가 아님
주 주소 / user, 대리 주소 / signer
공식 프로토콜의 실제 계정·서명 대리인 식별자
모든 상품에 입력란이 있지는 않음. 본 안내의 실제 항목 사용
하위 계정 주소
실제 Hyperliquid 하위 계정 0x 주소
주 계정은 비워 둠
메인넷 / 테스트넷 / 모의 거래
실제 자금 환경 / 별도 모의 환경
환경 간 키·자산 혼용 금지
단방향 / 헤지 모드
순포지션 또는 롱·숏 동시 보유 방식
단방향도 숏 가능. 교차·격리 증거금과 다른 설정
교차 / 격리 증거금
증거금의 포지션 위험 부담 방식
연결을 위해 임의 변경 금지
틱 / 슬리피지
최소 가격 단위 / 예상·실제 체결 가격 차이
5틱이 항상 5%인 것은 아님
순노출
두 레그를 공통 단위로 환산한 뒤의 미헤지 위험
다른 자산·승수·부분 체결은 노출을 남길 수 있음
S-S는 현물/현물, S-F는 현물/선물, F-F는 선물/선물입니다. 서로 다른 자산의 조합은 방향성 전략일 수 있으며 무위험 차익거래라고 가정하면 안 됩니다.