Project-V — Trading Console

Settings

설정

TradingView 알람과 MT5 EA에 입력할 URL입니다. 우측 복사 버튼으로 한 번에 복사하세요.

현재 도메인

TradingView Webhook

Webhook URL (TradingView 알람의 Webhook URL 칸)

알람 메시지 본문 예시 (Long)

MT5 EA Inputs (Windows VPS)

PendingURL — EA가 1초마다 폴링

AckURL Pattern — {cmd_id} 부분은 EA가 자동 치환

StatusURL — 체결/에러 콜백

MT5 → 도구 → 옵션 → Expert Advisors → "WebRequest 허용 URL"에 추가

상태 점검 / 디버그 URL

Health

Positions (JSON)

Trades (JSON)

Queue (JSON)

필수 시크릿 체크

⚠️ MISSING 항목이 있으면 Replit Tools → Secrets 에서 등록 후 봇을 재시작하세요.

DeepCoin 종목별 레버리지·마진 설정. 웹훅 시그널에는 SL/TP/방향만 들어오므로 진입 사이즈는 여기서 결정합니다. 저장 즉시 반영되며, 비워두면 글로벌 기본값을 사용합니다.

기본값 (글로벌): … — "기본값" 행은 글로벌 설정을 그대로 따라갑니다.

시그널	거래 심볼	사이징 모드	고정마진 (USDT)	시드비율 (%)	레버리지 (x)	상태	동작

사이징 모드
• fixed_margin — 매 진입마다 정해진 USDT를 마진으로 사용 (notional = margin × leverage)
• equity_pct — DeepCoin 잔고 × % 를 마진으로 사용 (잔고가 늘면 자동 증액)

새 종목 추가는 config.py의 SYMBOL_ROUTING에 한 줄 추가 후 재시작하면 이 표에 자동으로 나타납니다.

TradingView 시그널 심볼 → 채널 / 거래소 심볼 매핑. config.py의 SYMBOL_ROUTING에서 변경합니다.

시그널 심볼	채널	거래 심볼

테스트 시그널 전송

실제 /webhook 으로 TradingView 형식 메시지를 보냅니다 — 실주문이 체결될 수 있으니 주의.

빠른 프리셋

프리셋 클릭 시 아래 입력값이 자동으로 채워집니다.

시그널 심볼

방향

SL 거리 (%)

TP1 (%)

TP2 (%)

TP3 (%)

Dynamic SL (반대 시그널로 청산)

이 종목에 적용될 사이징 (실제 진입 시)

…

변경하려면 ⚙️ 설정 → "심볼 설정 (레버리지/마진)" 탭에서 저장하세요.

전송될 메시지 (미리보기)

진입은 시장가 · SL/TP는 현재가 기준 % 자동 계산

서버 응답

User Manual

사용 설명서

1. Project-V는 무엇인가요?

TradingView 알람(Webhook)을 받아 두 채널로 자동 매매하는 봇입니다.

DeepCoin 선물(USDT-SWAP) — Replit 봇이 REST로 직접 진입/청산
MT5 골드(XAUUSD) — Replit은 명령을 큐에 적재, Windows VPS의 EA가 폴링하여 실행

2. 대시보드 빠른 안내

Bot · DeepCoin · MT5 EA — 상단 상태 바에서 각 구성요소의 연결 상태를 확인합니다. 점이 초록이면 정상, 노랑은 지연, 빨강은 끊김입니다.

Offline · Mock — API 호출이 실패하면 표시되며, 화면은 임시 데이터로 채워집니다.

Live — 5초마다 자동 새로고침됩니다. 우측 상단 토글로 끌 수 있습니다.

KPI 4종 (PnL Today / Open Positions / Win Rate 7d / MT5 Queue)와 누적 Equity 곡선, 라이브 포지션, MT5 큐, 최근 거래 로그가 한 화면에 모입니다.

3. 초기 설정 체크리스트

Secrets 등록 — Replit Tools → Secrets 에서 다음 값을 입력합니다:
- DEEPCOIN_API_KEY / DEEPCOIN_API_SECRET / DEEPCOIN_API_PASSPHRASE
- TELEGRAM_TOKEN / TELEGRAM_CHAT_ID (선택)
- SEED_USD — 시드 자본 (기본 10000)
심볼 라우팅 확인 — 설정 → 심볼 라우팅 탭에서 매핑을 확인하세요. 변경은 config.py의 SYMBOL_ROUTING을 수정합니다.
TradingView Webhook URL 설정 — 알람 생성 시 다음 URL을 사용합니다:
```
{현재 도메인}/webhook
```
메시지 본문은 사용 중인 시그널 포맷을 그대로 사용합니다 (Long/Short, Entry, TP1~3, SL).
MT5 EA 설치 (골드 매매 시) — Windows VPS의 MT5에 Project-V.mq5를 컴파일·로드하고 Inputs에 폴링 URL을 입력합니다:
```
{현재 도메인}
PendingURL: {도메인}/mt5/pending
AckURL:     {도메인}/mt5/ack/{cmd_id}
StatusURL:  {도메인}/mt5/status
```
Always-On 배포 — Replit Deploy(Reserved VM)로 배포해야 24/7 작동합니다. 개발 도메인은 세션이 끊기면 봇도 멈춥니다.

4. 매매 흐름

TradingView가 /webhook으로 시그널 전송
SignalRouter가 심볼 → 채널 결정 (DeepCoin / MT5)
중복 시그널은 DEDUP_WINDOW_SEC(기본 180초) 동안 무시
DeepCoin: 즉시 시장가 진입 + TP1/2/3 + SL 주문
MT5: 명령을 큐(trades.db.mt5_commands)에 적재 → EA가 1초마다 폴링·실행 → 상태 콜백
모니터(monitor.py)가 1초마다 DeepCoin 포지션을 점검 — TP1 체결 시 SL을 진입가로 이동(BE), TP3·SL 체결 시 종료

5. 주요 옵션 설명

TP_RATIOS

TP1/TP2/TP3 분할 비율 (기본 1/3씩)

DYNAMIC_SL

반대 신호 수신 시 SL을 동적으로 갱신

BE_ON_TP1

TP1 체결 후 SL을 진입가로 이동 (Break-Even)

DEDUP_WINDOW_SEC

동일 (심볼, 방향) 중복 시그널 무시 기간

COIN_SIZING_MODE

fixed_margin: 매번 고정 USD / equity_pct: 잔고의 % 사용

COIN_LEVERAGE

DeepCoin 선물 레버리지 배수 (기본 10)

MT5_FIXED_LOT

MT5 골드 1회 진입 lot 수량 (기본 0.03)

SEED_USD

Equity 차트의 시작 시드 (대시보드 표시용)

6. 문제 해결

DeepCoin이 Disconnected로 표시됩니다

Secrets의 API Key/Secret/Passphrase 3개가 모두 정확한지 확인하세요. 거래소에서 IP 화이트리스트를 풀거나 Replit 도메인을 등록해야 할 수 있습니다.

MT5 EA가 Polling되지 않습니다

VPS에서 EA가 정상 작동 중인지, MT5 → 도구 → 옵션 → Expert Advisors → "WebRequest 허용 URL"에 봇 도메인이 추가되어 있는지 확인합니다. /mt5/pending 호출 시 status bar의 EA 점이 초록으로 바뀝니다.

시그널을 보냈는데 거래가 발생하지 않았습니다

최근 거래(Recent Trades) 탭에서 status를 확인하세요: ROUTING_REJECTED는 심볼이 라우팅 표에 없거나 파싱 실패, DUPLICATE는 중복창 내, CONNECT_ERROR는 거래소 연결 실패입니다. 자세한 사유는 raw_message의 view 버튼에서 확인합니다.

대시보드가 멈춰 보입니다

우측 상단 새로고침 버튼을 누르거나, 자동 새로고침 토글을 다시 켜 보세요. Offline·Mock 칩이 보이면 백엔드 API가 응답하지 않는 상태입니다.

Equity 곡선의 Seed 값을 바꾸려면?

Secrets에서 SEED_USD 값을 수정한 뒤 워크플로우를 재시작합니다. 차트는 시드 + 누적 PnL로 계산됩니다.

7. 단축키

Esc — 모달 닫기
Recent Trades 헤더 클릭 — 정렬 토글
CSV 버튼 — 현재 필터된 거래 내역을 CSV로 내려받기

Account

—

상태

—

오픈

0

오늘 거래

0

오늘 에러

0

대기 명령

0

EA 계정

—

마지막 retcode

—

EA 마지막 poll

—

웹훅 마지막 수신

—

TradingView Webhook URL

MT5 EA Polling URL

위 EA URL을 EA Inputs의 SlotA_URL / SlotB_URL / SlotC_URL 중 하나에 붙여넣고, 같은 슬롯의 SlotN_Magic(고유값)과 SlotN_LotFormula(예: 0 / 0.1 / 1000;0.1)을 설정하세요. Webhook URL은 TradingView 알림 칸에 그대로 사용합니다.

토큰 보이기

⚠ 이 URL을 가진 사람은 누구든 계정에 신호를 보낼 수 있습니다. 외부에 노출되면 즉시 "토큰 재발급"으로 회전하세요.

설정

이름 MT5 lot (override, 비우면 글로벌) 활성 메모

에러만

KST	심볼	사이드	상태	가격

새 계정 만들기

이름 채널 MT5 lot (선택, 비우면 글로벌 사용) 메모

Command detail

—

payload_json