ドキュメント

リスクエンジン & Webhookリファレンス

AlgoVestaが実行前にすべてのシグナルをどう検証するか、そしてTradingViewや任意のWebhookソースから送る正確なJSONペイロード。フィールド名はそのままなので、そのままコピーしてください。

AlgoVestaは3つのトリガーチャンネルから取引を実行します: AIアシスタント向けのMCPサーバー、Telegram信号、TradingViewウェブフックです。どのチャンネルが発火しても、同じサーバー側のリスクエンジンが取引所やMetaTrader 5口座に届く前に注文を検証します。このページは3つすべてを扱う技術リファレンスハブです。

取引をトリガーする3つの方法

どのチャンネルも同じ実行経路で終わります: 検証、サイジング、注文、そして取引所自体に置かれるストップロスとテイクプロフィットです。すでに使っている方法に合うチャンネルを選んでください。

AIアシスタント向けMCPサーバー

Claude、ChatGPT、Cursor、またはMCP対応のあらゆるクライアントを、1つの認証済みリンクで二十のネイティブ取引ツールに接続します。すべての接続は5,000ドルのペーパー残高から始まり、ライブキーは二要素認証を経て別途作成されます。認証はPKCE(S256)を使うOAuth 2.1、またはユーザーごとのシークレットリンクのいずれかです。

MCP開発者リファレンスAIアシスタントを接続する

Telegram信号チャンネル

すでにフォローしている信号チャンネルをAlgoVestaに向けます。メッセージはシンボル、方向、エントリー、ストップロス、目標値に解析された後、取引所で実行されるかMetaTrader 5に転送されます。明確に解析できない信号は推測せず拒否されます。

TelegramからMetaTrader 5へTelegramチャンネルを接続する

TradingViewウェブフック

任意のインジケーター、描画、またはPine戦略から、専用のウェブフックURLへアラートを送信します。アラート本文は以下に記載された形式の有効なJSONである必要があり、自動取引される信号はすべて、注文が開かれる前にその出所が検証されます。

TradingView自動化ペイロードリファレンス

リスクエンジン：シグナルの検証方法

シグナルが盲目的に実行されることはありません。注文が出される前に、ライブ市場の状況とあなたが設定した制限に照らして確認する複数モジュールの検証レイヤーを通過します。ハードルールに反した場合、シグナルは縮小ではなく拒否されます。

ニューラルスコアリング — スコアリングモデルによる0–100の信頼スコア。
出来高 & オーダーフロー — 出来高の急増と攻撃的約定の偏り（VPIN）。
市場レジーム — トレンド／レンジ／平均回帰の分類。
ファンディング & 清算 — ファンディングレートの動きと清算クラスター。
ストップロス・マッピング — 既知の流動性クラスター内にストップを置かないようにする。
あなたのハードルール — 方向、セッション時間、ポジション・ドローダウンの制限。

正確なモジュール構成としきい値はプラットフォームの調整に伴って変わります。原則は一定です：注文が取引所に届く前に、あなたのルールとリスク制限が常に適用されます。

日次損失＆ドローダウン保護

シグナルごとのチェックに加え、口座レベルの2つの保護が常時稼働します。

日次損失リミット — その日の確定損失が設定したリミット（残高の割合または固定額）に達すると、AlgoVestaはセーフモードに移行し、翌日まで新規取引を停止します。
ドローダウン連動サイジング — 口座のドローダウンが大きくなるほど、ポジションサイズが段階的に（慎重 → 防御 → サバイバル）自動的に縮小され、連敗がエクスポージャーを拡大するのではなく縮小します。

Webhookペイロード・リファレンス

AlgoVestaのWebhook 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任意forex のみ — ロット単位のポジションサイズ。設定済みのロット/リスクモードを使う場合は省略してください。
leverage任意crypto のみ — その銘柄に対する取引所の上限が適用されます。
amount_usd任意crypto のみ — 証拠金であり、想定元本ではありません。想定元本 = 証拠金 × レバレッジ。
risk_percent任意crypto のみ — リスクに晒す残高の割合（0.1〜50%）。
quantity任意crypto のみ — 正確な契約数量。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 も有効な値です。

ポジションサイズ、レバレッジ、シグナルごとのリスクは、ダッシュボードまたはペイロードのいずれかから設定できます — ペイロード内の値が優先されます。だからこそwebhook URLはシークレットなのです：IP許可リストを追加すれば、AlgoVestaは送信元を検証できたシグナルのみを自動取引します。

ポジションを決済する

シンボルとともに "action": "close" を送信してください。そのシンボルのポジション全体が決済されます — 部分決済には対応していません。部分決済を指定した場合もポジション全体が決済され、その旨がパネルに表示されます。

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

Pine ストラテジーアラート — 決済は自動で処理されます

「Order fills only」を指定した Pine の strategy() からアラートを作成する場合、action だけを送信してはいけません。{{strategy.order.action}} は決済時にも 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個すべてのツール、3つのスコープ、OAuth 2.1とシークレットリンク認証、レート制限、エラーコード、対応する16の取引所とMetaTrader 5が文書化されています。

実際の資金を使わずにテストできますか?

はい。すべてのMCP接続は、実際の市場価格を反映した5,000ドルの仮想ペーパー残高から始まり、TradingViewとTelegramの自動化にはどちらも信号から注文までの全フローをシミュレートするデモモードがあります。実取引には常に別途明示的に作成したキーまたは接続が必要です。