확장 마켓 사용 문서

리스크 안내: 확장 마켓은 전략과 도구를 배포하는 기능이며, 수익을 보장하지 않습니다. 모든 확장 블루프린트는 실거래 전에 반드시 백테스트와 시뮬레이션 실행을 거친 뒤, 소액 실거래만 검토해야 합니다. 거래소 API에는 출금 권한을 활성화하지 마십시오.

앱을 연 뒤 상단 내비게이션에서 확장 페이지로 이동합니다.

페이지는 두 영역으로 나뉩니다.

왼쪽과 오른쪽 사이의 구분선을 드래그해 내 확장 패널의 너비를 조정할 수 있습니다.

내 확장 패널은 현재 환경과 관련된 확장을 관리하고 확인하는 곳입니다.

여기에는 두 종류의 항목이 나타날 수 있습니다.

• 이 컴퓨터에 이미 다운로드되고 설치된 확장.
• 현재 로그인한 계정이 클라우드에서 보유하거나 추가한 확장.

주의할 점: 앱은 확장이 "설치됨"인지 판단할 때 주로 이 컴퓨터에 해당 마켓 블루프린트 파일이 있는지를 확인합니다. 클라우드 계정 목록만 보지 않습니다. 따라서 어떤 확장이 클라우드에서는 내 계정에 속해 있어도, 현재 컴퓨터에 다운로드되지 않았다면 설치되지 않은 상태로 표시될 수 있습니다.

자주 보이는 배지:

자주 사용하는 작업:

확장 마켓 홈에는 설치 가능한 확장 목록이 표시됩니다. 기본 정렬은 다운로드 수가 많고 평점이 높은 확장을 우선 표시합니다.

다음 방식으로 목록을 줄일 수 있습니다.

• 키워드 검색: 검색창에 확장 이름, 작성자, 요약, 카테고리, 마켓 유형 등의 키워드를 입력한 뒤 검색을 클릭하거나 Enter를 누릅니다.
• 카테고리 필터: 전략, 리스크 관리, 신호, 도구 등 확장 카테고리별로 확인합니다. 실제 카테고리는 마켓 백엔드에서 제공됩니다.
• 마켓 유형 필터: Spot 또는 Futures처럼 확장이 지원하는 마켓으로 필터링합니다.

검색 결과가 없으면 키워드를 지우고 카테고리와 마켓 유형을 전체로 되돌리십시오.

마켓 목록의 각 확장 카드는 핵심 정보를 표시합니다.

블루프린트 확장은 일반적으로 전략 흐름에 직접 사용하기 좋습니다. 스크립트 또는 도구 확장은 상세 페이지의 사용 설명을 읽어야 합니다.

확장 카드를 클릭하면 상세 페이지로 이동합니다. 상세 페이지는 헤더 정보, 설명 영역, 댓글 영역, 오른쪽 정보 패널로 구성됩니다.

다음 내용을 중점적으로 확인하십시오.

상세 페이지에 "확장 설명 없음" 또는 "변경 로그 없음"이 표시되면 게시자가 해당 내용을 제공하지 않은 것입니다. 이 경우 더 신중하게 사용하고 충분한 백테스트를 먼저 실행하십시오.

설치 절차:

1. 확장 페이지로 이동합니다.
2. 마켓 목록에서 대상 확장을 검색하거나 필터링합니다.
3. 확장 카드를 클릭해 상세 페이지를 엽니다.
4. 상세, 변경 로그, 댓글, 백테스트 정보를 읽습니다.
5. 설치를 클릭합니다.
6. 확장에 액세스 코드가 필요하면 팝업에 코드를 입력하고 확인합니다.
7. 설치 성공 메시지를 기다립니다.
8. 블루프린트 페이지 또는 리소스 관리에서 새로 설치된 마켓 블루프린트를 확인합니다.

블루프린트 확장을 설치할 때 앱은 확장 패키지를 로컬 마켓 블루프린트 디렉터리에 다운로드하고 블루프린트 작업 공간을 새로고침합니다. 설치 후 확장에는 마켓 출처 정보, 버전 정보, 패키지 검증 정보, 다운로드 시간이 보관되어 이후 설치 상태와 버전 업그레이드를 식별하는 데 사용됩니다.

설치에는 해당 권한이 필요할 수 있습니다. 현재 계정에 다운로드 권한이 없으면 앱이 권한 안내를 표시합니다.

확장 마켓은 여러 다운로드 방식을 지원합니다.

코드가 필요한 확장은 설치 중 입력창이 표시됩니다. 코드가 비어 있거나 올바르지 않으면 설치가 계속되지 않습니다. 대소문자, 공백, 유효 기간을 확인하십시오.

블루프린트 확장은 백테스트 미리보기를 지원합니다. 설치 전에 확장을 더 검토할 가치가 있는지 빠르게 판단하는 데 적합합니다.

백테스트 미리보기의 특징:

• 블루프린트 확장만 백테스트 미리보기를 지원합니다.
• 백테스트 미리보기는 마켓에서 원격 블루프린트 미리보기를 가져오며, 로컬 블루프린트 파일에 직접 쓰지 않습니다.
• 앱은 블루프린트가 컴파일 가능한지 먼저 확인한 뒤 백테스트 창을 엽니다.
• 백테스트 창은 자동으로 실행을 시작합니다.
• 기본 거래쌍은 블루프린트의 기존 설정을 우선 사용하며, 설정이 없으면 BTCUSDT를 사용합니다.

기본 백테스트 기간은 블루프린트 실행 주기에 따라 자동으로 결정됩니다.

미리보기 백테스트 결과는 과거 데이터 기준의 한 번의 테스트 성과일 뿐입니다. 정식 사용 전에는 설치 후 블루프린트 페이지에서 거래쌍, 주기, 수수료, 슬리피지, 자금, 레버리지, 더 긴 기간을 다시 설정하고 여러 번 백테스트하는 것이 좋습니다.

블루프린트 확장 설치가 완료되면 로컬 블루프린트 작업 공간에 들어갑니다. 권장 흐름:

1. 블루프린트 페이지를 엽니다.
2. 블루프린트 목록 또는 리소스 관리에서 설치된 마켓 블루프린트를 찾습니다.
3. 블루프린트를 열고 노드 구조, 파라미터, 실행 주기, 마켓 유형, 리스크 관리 노드를 먼저 확인합니다.
4. 과거 백테스트를 실행하고 손익, 드로다운, 승률, 거래 횟수, 주문 로그를 확인합니다.
5. 거래 페이지에서 대상 차트 또는 계정에 블루프린트를 마운트합니다.
6. 먼저 시뮬레이션 거래 모드로 실행하며 신호 트리거, 주문 의도, 리스크 관리 차단을 관찰합니다.
7. 동작이 안정적이라고 확인한 뒤 소액 실거래를 검토합니다.

실거래 전에는 다음을 중점적으로 확인하십시오.

• 현재 계정이 맞는지.
• 거래쌍과 마켓 유형이 일치하는지. 예: 현물 또는 선물.
• 레버리지, 마진 모드, 포지션 비율이 감당 가능한 범위인지.
• 전략에 빈도 제한, 최대 포지션, 손절, 쿨다운, 킬 스위치 등 리스크 관리가 포함되어 있는지.
• API에 필요한 권한만 켜져 있고 출금 권한은 없는지.

설치된 확장에 업그레이드 가능 배지가 표시되면 상세 페이지 또는 내 확장 패널에서 업그레이드를 클릭할 수 있습니다.

업그레이드 전에 세 가지를 먼저 하십시오.

1. 변경 로그를 확인해 새 버전에서 무엇이 바뀌었는지 파악합니다.
2. 실행 중인 블루프린트 마운트를 중지합니다.
3. 비교를 위해 현재 버전의 핵심 파라미터와 백테스트 결과를 기록합니다.

업그레이드 규칙:

• 현재 설치 흐름에서는 블루프린트 확장만 버전 업그레이드 판단을 지원합니다.
• 현재 버전이 이미 최신이면 업그레이드가 필요 없다는 안내가 표시됩니다.
• 해당 블루프린트 확장에 실행 중인 마운트가 있으면 앱은 업그레이드를 거부하며, 먼저 마운트를 중지해야 합니다.
• 실행 중이 아닌 마운트가 있으면 업그레이드 확인 팝업에 수량이 표시됩니다. 확인 후 앱은 해당 마운트의 블루프린트 버전 스냅샷을 동기화합니다.
• 업그레이드는 로컬 블루프린트 ID를 유지하고 같은 마켓 확장의 이전 버전 파일을 정리합니다.

업그레이드가 끝난 뒤 실거래를 바로 재개하지 마십시오. 먼저 새 버전을 백테스트하고, 시뮬레이션 실행으로 동작이 기대와 맞는지 확인하십시오.

제거는 이 컴퓨터의 해당 마켓 블루프린트 파일을 삭제하고 현재 사용자 확장 관계에서 제거합니다.

제거 절차:

1. 내 확장 또는 상세 페이지에서 대상 확장을 찾습니다.
2. 제거를 클릭합니다.
3. 확인 팝업을 읽습니다.
4. 확인한 뒤 제거가 완료될 때까지 기다립니다.

제거 규칙:

• 확장에 실행 중인 마운트가 있으면 앱은 제거를 거부합니다. 먼저 마운트를 중지해야 합니다.
• 확장에 실행 중이 아닌 마운트가 있으면, 제거를 확인할 때 해당 마운트도 함께 정리됩니다.
• 제거가 완료되면 블루프린트 작업 공간이 새로고침되고 확장은 더 이상 로컬 설치 확장으로 표시되지 않습니다.

전략 거래를 잠시 멈추려는 것뿐이라면 먼저 마운트를 중지하거나 자동 거래를 끄십시오. 더 이상 사용하지 않는다고 확신할 때만 제거하십시오.

설치된 확장은 상세 페이지에서 평가를 클릭해 평가할 수 있습니다.

평가 규칙:

• 1~5개의 별을 선택해야 합니다.
• 댓글 내용을 입력해야 합니다.
• 제출에 성공하면 댓글 영역이 새로고침됩니다.
• 댓글 API에 짧은 지연이 있으면 앱은 이번 댓글을 로컬 목록에 임시로 표시하고, 이후 새로고침 시 서버 데이터로 대체합니다.

댓글 영역에는 일반 사용자, 작성자, 관리자 답글이 표시될 수 있습니다. 작성자 또는 관리자 표시는 댓글 출처만 나타내며 전략 수익을 보장하지 않습니다.

네트워크와 로그인 상태를 확인한 뒤 내 확장 옆의 새로고침 버튼을 클릭하거나 확장 페이지에 다시 들어가십시오. 마켓 API가 일시적으로 사용할 수 없으면 목록이 비어 있을 수 있습니다.

키워드를 지우고 카테고리와 마켓 유형을 전체로 되돌리십시오. 검색은 현재 마켓 목록 안의 이름, 작성자, 요약, 카테고리, 다운로드 방식, 마켓 유형 등의 필드만 매칭합니다.

대부분 현재 컴퓨터에 로컬 설치 파일이 없다는 뜻입니다. 다운로드 및 설치를 클릭하십시오. 설치가 완료된 후에야 설치됨으로 바뀝니다.

다운로드 주소 사용 불가, 네트워크 이상, 액세스 코드 오류, 계정의 다운로드 권한 부족, 확장 패키지 형식 이상, 블루프린트 컴파일 검증 실패가 원인일 수 있습니다. 마켓을 새로고침하고 다시 시도하십시오. 코드가 필요한 확장은 코드가 정확한지 확인해야 합니다.

먼저 블루프린트 페이지로 전환하고 리소스 관리를 새로고침하십시오. 그래도 보이지 않으면 확장 페이지로 돌아가 새로고침하십시오. 설치 상태는 로컬 마켓 블루프린트 파일을 기준으로 하므로, 파일이 삭제되었거나 디렉터리에 쓰기 권한이 없으면 표시가 영향을 받을 수 있습니다.

원격 미리보기 블루프린트 가져오기 실패, 블루프린트 컴파일 실패, 백테스트 창 미준비, 현재 시장 데이터 사용 불가가 원인일 수 있습니다. 상세 페이지에서 백테스트 미리보기를 다시 클릭하거나, 설치 후 블루프린트 페이지에서 수동으로 백테스트하십시오.

업그레이드 가능 배지가 없으면 현재 버전이 이미 최신이거나 버전 번호를 안정적으로 비교할 수 없는 상태입니다. 실행 중인 마운트가 있으면 먼저 중지한 뒤 업그레이드하십시오.

해당 확장에 실행 중인 마운트가 있으면 앱이 제거를 막습니다. 거래 또는 리소스 관리에서 해당 마운트를 중지한 뒤 확장 마켓으로 돌아와 제거하십시오.

현재 계정에 평가 권한이 있는지 확인하고 네트워크 상태를 점검하십시오. 별점을 선택하고 댓글 내용을 입력해야 합니다.

확장 마켓을 처음 사용할 때는 다음 순서를 권장합니다.

1. 확장 마켓에서 대상 확장을 검색하거나 필터링합니다.
2. 상세 페이지를 열고 설명, 변경 로그, 댓글, 백테스트 정보를 읽습니다.
3. 블루프린트 확장은 먼저 백테스트 미리보기를 실행합니다.
4. 확장을 설치합니다.
5. 블루프린트 페이지로 이동해 다시 백테스트하고 파라미터와 리스크 관리를 확인합니다.
6. 시뮬레이션 거래 모드로 마운트해 실행합니다.
7. 로그, 주문, 리스크 관리 차단, 계정 변화를 관찰합니다.
8. 여러 차례 검증한 뒤 소액 실거래를 검토합니다.
9. 업그레이드 전 실행 중인 마운트를 중지하고, 업그레이드 후 다시 백테스트합니다.
10. 더 이상 사용하지 않을 때는 먼저 마운트를 중지한 뒤 확장을 제거합니다.