문서

리스크 엔진 & 웹훅 레퍼런스

Q: 전체 MCP 도구 참조 문서는 어디에서 찾을 수 있나요?

MCP 개발자 참조 문서 에는 20개 도구 전체, 세 가지 범위(scope), OAuth 2.1 및 시크릿 링크 인증, 요청 제한, 오류 코드, 지원되는 16개 거래소와 MetaTrader 5가 문서화되어 있습니다.

AlgoVesta가 실행 전에 모든 신호를 어떻게 검증하는지, 그리고 TradingView나 모든 웹훅 소스에서 보낼 정확한 JSON 페이로드. 필드 이름은 그대로이니 복사해서 사용하세요.

AlgoVesta는 세 가지 트리거 채널에서 거래를 실행합니다: AI 어시스턴트를 위한 MCP 서버, Telegram 신호, TradingView 웹훅입니다. 어떤 채널이 발동하든, 동일한 서버 측 리스크 엔진이 주문이 거래소나 MetaTrader 5 계정에 도달하기 전에 이를 검증합니다. 이 페이지는 세 가지 모두를 다루는 기술 참조 허브입니다.

거래를 트리거하는 세 가지 방법

모든 채널은 동일한 실행 경로로 끝납니다: 검증, 사이징, 주문, 그리고 거래소 자체에 배치되는 손절매 및 익절매입니다. 이미 사용하는 방식에 맞는 채널을 선택하세요.

AI 어시스턴트를 위한 MCP 서버

Claude, ChatGPT, Cursor 또는 MCP를 지원하는 모든 클라이언트를 하나의 인증된 링크로 스무 개의 네이티브 거래 도구에 연결하세요. 모든 연결은 5,000달러 페이퍼 잔고로 시작하며, 실거래 키는 2단계 인증을 거쳐 별도로 생성됩니다. 인증은 PKCE(S256)를 사용하는 OAuth 2.1 또는 사용자별 시크릿 링크 중 하나입니다.

MCP 개발자 참조 문서 AI 어시스턴트 연결하기

Telegram 신호 채널

이미 팔로우하고 있는 신호 채널을 AlgoVesta에 연결하세요. 메시지는 심볼, 방향, 진입가, 손절매, 목표가로 파싱된 후 거래소에서 실행되거나 MetaTrader 5로 전달됩니다. 명확하게 파싱할 수 없는 신호는 추측하지 않고 거부됩니다.

Telegram에서 MetaTrader 5로 Telegram 채널 연결하기

TradingView 웹훅

모든 지표, 드로잉 또는 Pine 전략에서 개인 웹훅 URL로 알림을 보내세요. 알림 본문은 아래에 문서화된 형식의 유효한 JSON이어야 하며, 자동으로 거래되는 모든 신호의 출처는 주문이 열리기 전에 검증됩니다.

TradingView 자동화 페이로드 참조

리스크 엔진: 신호는 어떻게 검증되나

신호는 절대 맹목적으로 실행되지 않습니다. 주문이 실행되기 전에 실시간 시장 상황과 여러분이 설정한 한도를 대조하는 다중 모듈 검증 계층을 거칩니다. 강제 규칙이 실패하면 신호는 축소가 아니라 거부됩니다.

뉴럴 스코어링 — 스코어링 모델의 0–100 신뢰 점수.

거래량 & 오더플로우 — 거래량 급증과 공격적 체결 불균형(VPIN).

시장 국면 — 추세 / 횡보 / 평균회귀 분류.

펀딩 & 청산 — 펀딩 비율 동학과 청산 클러스터.

스톱로스 매핑 — 알려진 유동성 클러스터 안에 스톱을 두지 않도록 함.

여러분의 강제 규칙 — 방향, 세션 시간, 포지션·드로다운 한도.

정확한 모듈 구성과 임계값은 플랫폼 튜닝에 따라 달라집니다. 원칙은 변하지 않습니다: 주문이 거래소에 도달하기 전에 여러분의 규칙과 리스크 한도가 항상 적용됩니다.

일일 손실 및 드로다운 보호

신호별 점검 외에도 계좌 수준의 두 가지 보호 장치가 지속적으로 작동합니다.

일일 손실 한도 — 당일 실현 손실이 설정한 한도 — 잔고의 비율 또는 고정 금액 — 에 도달하면 AlgoVesta는 안전 모드로 전환되어 다음 날까지 새 거래를 열지 않습니다.

드로다운 기반 사이징 — 계좌 드로다운이 커질수록 포지션 크기가 단계적으로(신중 → 방어 → 생존) 자동 축소되어, 연속 손실이 노출을 키우는 대신 줄입니다.

웹훅 페이로드 레퍼런스

AlgoVesta 웹훅 URL로 JSON 본문의 HTTP POST를 보내세요. TradingView에서는 알림 메시지 상자에 붙여넣으세요. 필드 이름은 정확히 일치해야 합니다.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }

필드	필수	설명
`symbol`	예	거래소 거래 페어, 예: BTCUSDT.
`side` / `action`	예	주문 방향: buy 또는 sell.
`price`	선택	진입 기준 가격; 시장가 진입 시 생략.
`stop_loss`	선택	스톱로스 가격. 모든 신호에 권장.
`take_profit`	선택	익절 가격. 앱에서 다중 목표 설정 가능.
`market`	선택	대상 시장: `crypto`(기본값) 또는 `forex`. forex로 설정하면 MetaTrader 5로 전송됩니다. 심볼로부터 추론되지 않습니다.
`lots`	선택	포렉스 전용 — 랏 단위 포지션 크기입니다. 설정된 랏/리스크 모드를 사용하려면 생략하세요.
`leverage`	선택	암호화폐 전용 — 해당 심볼에 대한 거래소 한도가 적용됩니다.
`amount_usd`	선택	암호화폐 전용 — 명목 가치가 아닌 증거금입니다. 명목 가치 = 증거금 × 레버리지.
`risk_percent`	선택	암호화폐 전용 — 리스크에 노출할 잔고 비율(0.1–50%)입니다.
`quantity`	선택	암호화폐 전용 — 정확한 계약 수량입니다. `qty`, `size`, `contracts`는 별칭으로 허용됩니다.
`take_profits`	선택	다중 목표가: `[{"price":…, "close_pct":…}]`. `tpN_close`와 함께 `tp1`…`tp5`도 사용할 수 있습니다.
`trailing`	선택	`{"trigger_pct":…, "distance_pct":…}` — 트레일링 스톱.
`breakeven`	선택	`true` 또는 `{"trigger_pct":…}` — 수익 구간에 진입하면 스톱을 진입가로 이동합니다.

거래소 접두사는 제거되므로 BINANCE:BTCUSDT는 BTCUSDT와 동일하게 동작합니다. 방향 필드에서는 direction과 type이 action의 별칭으로 허용되며, close도 유효한 값입니다.

포지션 크기, 레버리지, 신호당 리스크는 대시보드 또는 페이로드에서 설정할 수 있으며 — 페이로드의 값이 우선합니다. 그래서 웹훅 URL은 시크릿입니다: IP 허용 목록을 추가하면 AlgoVesta는 출처를 검증할 수 있는 신호만 자동으로 거래합니다.

포지션 종료

심볼과 함께 "action": "close"를 보내세요. 해당 심볼의 전체 포지션이 종료됩니다 — 부분 종료는 지원되지 않습니다. 부분 종료를 요청하더라도 전체 포지션이 종료되며 패널에 그렇게 표시됩니다.

{ "symbol": "BTCUSDT", "action": "close" }

Pine 전략 알림 — 청산은 자동으로 처리됩니다

Pine strategy()로 “Order fills only” 옵션을 사용해 알림을 만드는 경우, action만 단독으로 보내지 마세요. {{strategy.order.action}}은 청산(exit) 시에도 sell을 반환하므로, 포지션을 종료하는 대신 숏 포지션을 열게 됩니다. 포지션 상태 필드를 포함하면 AlgoVesta가 진입, 청산, 방향 전환을 알아서 처리합니다.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }

체결 후 포지션	AlgoVesta의 동작
`flat` (or `position_size` = 0)	포지션을 종료합니다. 반대 방향 주문은 열리지 않습니다.
이전 상태의 반대	방향 전환 — 먼저 종료한 다음 새로운 방향으로 포지션을 엽니다. 종료가 실패하면 아무것도 열리지 않습니다.
이전과 동일한 방향	해당 방향으로의 진입으로 처리됩니다.

메시지는 JSON 형식이어야 합니다. 유효한 JSON이 아니면 TradingView는 알림 본문을 일반 텍스트로 전송합니다 — 기본 메시지(예: “BTCUSDT Crossing 1.00”)에는 방향 정보가 없어 거부됩니다. 모호한 텍스트에 대해서는 추측하지 않습니다. 잘못된 방향으로 주문을 여는 것보다 신호를 거부하는 것이 더 안전합니다. 또한 TradingView는 3분 내 15회 발생 시 알림을 자동으로 중단한다는 점도 참고하세요.

노코드 빌더

JSON을 손으로 쓰지 말고 시각적으로 만드세요

방향, 익절 / 스톱로스(단일 또는 다중), 레버리지, 포지션 크기, 트레일링, 브레이크이븐을 간단한 토글로 설정하세요. AlgoVesta가 정확한 TradingView 알림 메시지를 생성합니다 — 복사해서 알림에 붙여넣으세요.

비주얼 빌더 작동 방식 보기 → 단계별 알림 설정 →

자주 묻는 질문

AlgoVesta에서 어떤 채널이 거래를 트리거할 수 있나요?

세 가지입니다: AI 어시스턴트가 사용하는 MCP 서버, Telegram 신호 채널, TradingView 웹훅입니다. 대시보드에서 수동으로 거래를 열 수도 있습니다. 모든 채널은 동일한 실행 경로와 동일한 리스크 검사를 거칩니다.

TradingView에 웹훅 JSON 형식이 필요한가요?

예. TradingView는 알림 본문이 유효한 JSON이 아니면 일반 텍스트로 전송하며, 기본 알림 메시지에는 방향 정보가 없으므로 거부됩니다. 위의 웹훅 페이로드 참조에 문서화된 페이로드 형식을 사용하거나, 시각적으로 만든 결과를 알림에 붙여넣으세요.

리스크 엔진이 MCP 및 Telegram 주문에도 적용되나요?

예 — 모든 채널에서 동일한 서버 측 검사가 실행됩니다. 주문이 AI 어시스턴트, Telegram 신호, TradingView 알림 중 어디에서 왔든, 거래소에 도달하기 전에 리스크 정책, 손절매 요구 사항, 포지션 및 드로다운 한도가 적용됩니다. 어떤 프롬프트나 메시지로도 이를 완화할 수 없습니다.

전체 MCP 도구 참조 문서는 어디에서 찾을 수 있나요?

MCP 개발자 참조 문서에는 20개 도구 전체, 세 가지 범위(scope), OAuth 2.1 및 시크릿 링크 인증, 요청 제한, 오류 코드, 지원되는 16개 거래소와 MetaTrader 5가 문서화되어 있습니다.

실제 자금 없이 테스트할 수 있나요?

예. 모든 MCP 연결은 실제 시장 가격을 반영한 5,000달러 가상 페이퍼 잔고로 시작하며, TradingView와 Telegram 자동화 모두 신호에서 주문까지 전체 흐름을 시뮬레이션하는 데모 모드를 제공합니다. 실거래는 항상 별도로 명시적으로 생성한 키 또는 연결이 필요합니다.