로컬 에이전트

실거래는 이용자 기기(권장: VPS)에서 24시간 도는 로컬 에이전트가 담당합니다. 키·서명·주문 전송이 전부 이 안에서 일어납니다.

서버는 어디에 두나요

거래하려는 거래소와 가까운 리전을 고르세요 — 주문 왕복 시간이 곧 체결 품질입니다. 예: 업비트 위주면 한국(서울), 바이낸스 위주면 일본(도쿄)·싱가포르 리전이 일반적으로 유리합니다.

주문은 에이전트에서 거래소로 직접 나갑니다 — 코인소리 서버를 거치지 않으므로, 코인소리로 인한 추가 지연은 0 입니다(비수탁 구조의 부수 효과). 서버 위치로 결정되는 건 순수하게 에이전트↔거래소 거리뿐입니다.

설치

1. 트레이딩 → 에이전트 관리에서 페어링 코드를 발급합니다(1회용, 유효시간 있음).

2. 화면에 표시되는 원클릭 설치 명령을 VPS 터미널에 붙여넣습니다 — systemd 서비스로 등록되어 재부팅해도 자동 실행됩니다.

서버 만들기가 처음이라면: Amazon Lightsail 5~10분 초보자 가이드 — 서울 리전에 월 $7 서버를 만들고 브라우저 SSH 로 설치 명령을 붙여넣는 과정 전체를 스크린샷으로 안내합니다.

3. 연결되면 에이전트 카드가 온라인으로 바뀝니다.

외환(MT5)

외환은 API 키가 없습니다. 내 브로커의 MetaTrader 5 가 에이전트와 같은 Windows 컴퓨터(또는 Windows VPS)에서 돌고, 터미널에 붙인 SoriBridge EA 가 이 컴퓨터 안에서만 에이전트와 이야기합니다. 브로커 로그인은 MT5 밖으로 나가지 않습니다. 설치(Windows 원라인 설치기가 EA 를 같이 넣습니다) → MT5 옵션 → EA 를 차트 하나에 붙이기 → 시세창에 종목 올리기 → 캔들 저장소에 종목 추가 → 페이퍼 → 데모 계좌 → 실계좌. 순서대로 따라 할 수 있는 안내는 외환(MT5) 시작하기. 지금(v1)은 시장가 주문만, 한 실행에 터미널(계좌) 하나입니다 — 그 터미널의 종목은 여럿 고를 수 있습니다. 한도·시작 자금·손익은 터미널의 계좌 통화이고, 1회 주문 한도가 어느 종목의 최소 랏(예: EURUSD 0.01랏 ≈ 1,000 EUR 노출)보다 작으면 그 종목 이름과 함께 배포가 막힙니다.

지문 확인

웹과 에이전트 콘솔 양쪽에 같은 지문(fingerprint) 이 표시됩니다. 다르면 중간자 공격 의심 — 키를 입력하지 마세요(다르면 키 입력 UI 자체가 숨겨집니다).

API 키 등록

에이전트 카드에서 거래소 키를 등록합니다. 키는 E2E 암호문으로 전달되어 에이전트 로컬에만 암호화 저장됩니다. 출금 권한이 있으면 등록이 거부됩니다. 가장 보수적인 경로로는 에이전트 콘솔 명령(중계조차 안 거침)도 있습니다.

운영

  • 기본은 dry-run. 실주문 스위치는 웹에서 E2E 로 켭니다.
  • 전략 배포·정지·킬스위치 해제·로그 확인은 전략 스튜디오와 통합 현황에서.
  • 에이전트가 오프라인이면 화면에 그렇게 표시됩니다 — 온라인인 척하지 않습니다.

제거 — 흔적 없이

은행 보안 프로그램처럼 "지워지지 않는 상주 프로그램"이 되지 않는 것이 설계 원칙입니다. 에이전트는 표준 위치에만 설치되고(커널 확장·루트 데몬 없음), 한 줄로 깨끗하게 제거됩니다:

curl -fsSL https://coinsori.com/dl/uninstall.sh | bash

한 번에 다 끝납니다: 서버 쪽 페어링 해제 → 서비스 등록(systemd/launchd) 해제 → 프로그램 폴더 삭제 → 페어링 정보(~/.coinsori-agent) 삭제. 무엇을 지웠는지 전부 출력하고, 이 컴퓨터에 남는 것은 없습니다. 웹 '에이전트 관리'에 다시 갈 필요도 없어요(목록에서도 바로 사라집니다). 서버에 연결하지 못하면 그 사실을 알려줍니다 — 그때만 웹에서 지워 주세요.