Freya Financeでシグナルボットを作成する方法

#Freya Financeでシグナルボットを作成する方法

シグナルボットは、外部からシグナルを受け取ったときに取引を実行します — 最も一般的なのは、Webhookに送信されるTradingViewアラートです。DCAボットのようにエントリーロジックをFreyaの中で組み立てるのではなく、別のプラットフォームからご自身のシグナルを持ち込み、シグナルボットがそれを取引所での実際の取引に変えます。

すでに他の場所で信頼している戦略やインジケーター設定をお持ちなら、シグナルボットはそれをFreyaで自動化する手段です。（ロジックをFreyaの中で構築したい場合は、代わりに初めてのDCAボットを作成する方法から始めてください。）

---

#シグナルボットとは

DCAボットでは、エントリー条件をFreyaの中で設定します。シグナルボットはその逆です。いつエントリーするか、いつ退出するかという判断は外部から来ます — あなたのチャートプラットフォーム、ご自身のスクリプト、あるいはWebhookを送信できる任意のツールです。そのシグナルが届いたとき、シグナルボットが取引を発注します。外部戦略と取引所でのライブ執行をつなぐ橋渡し役です。

#手順の概要

1. ボットを作成し、シグナルボットタイプを選び、取引ペアと方向を選択します。
2. シグナルモードを選択 — カスタムシグナル、またはリスク比率（Webhookが利益確定と損切りを運びます）。
3. Webhook URLをコピー — カスタムシグナルではオープン用とクローズ用の2つ、リスク比率では単一のURLが与えられます。
4. シグナルソースを接続 — それらのURLをTradingViewアラート（または他のツール）に貼り付けます。
5. 注文設定を行い、起動します。以降は、あなたのシグナルがボットを動かします。

#ステップ1：シグナルボットタイプを選ぶ

ボット作成フローでシグナルボット（「Webhookシグナルに基づいて取引を実行」）を選択し、他のボットと同じように取引ペアと方向を選びます。

#ステップ2：シグナルモードを選ぶ

シグナルモードは、受信したシグナルをボットがどう解釈するかを制御します。モードは2つあり、どちらか一方を選びます — 組み合わせることはできません：

• カスタムシグナル — ボットは、あなたがWebhook経由で送るオープンシグナルとクローズシグナル（例えばTradingViewアラートから）に従って動き、注文はあなた自身がFreyaで設定します：取引金額、そして利益確定と損切りです。
• リスク比率 — Webhookペイロードが利益確定と損切りの価格を運びます。エントリーは、シグナルが発火した時点の成行価格で取られます。取引金額を選ぶ代わりに、1取引あたりの固定リスク額を設定すると、Freyaがエントリーと損切りの距離からポジションサイズを自動計算します。結果として、損切りに達した場合の損失は、あなたが選んだリスク額とほぼ同じになります。利益確定はWebhookの価格で指値注文として発注されます（そのためスリッページなしで約定します）。損切りはトリガー時に成行注文として執行されるため、他のストップと同様、急変時にはスリッページが発生する可能性があります。

シグナルの組み立て方に合ったモードを選んでください。

#リスク比率モードが強力な理由

リスク比率モードは、ポジションサイジングの考え方を逆転させます。通常はポジションサイズを先に決め、損切りが意味する損失額はその結果として受け入れます。リスク比率モードでは、受け入れる損失額を先に選び、ポジションサイズがそれに合わせて自動的に決まります。これにより、損切りがどれだけ離れていても1取引あたりのリスクが一定に保たれます — プロが用いる規律あるアプローチです。リスクタイプと固定金額は戦略ステップで設定します。すると取引金額は動的と表示されます。Webhookが届いた時点で計算されるためです。

#ステップ3：Webhook URLを取得する

どのURLが与えられるかはモードによって異なります：

• カスタムシグナルモードでは、ボットにオープンWebhook URL（呼び出すとポジションを開きます）と、それとは別のクローズWebhook URL（呼び出すとポジションをクローズします）が与えられます。
• リスク比率モードでは、エントリーシグナル用の単一のWebhook URLが与えられます。ポジションはその後、Webhookに含まれる利益確定と損切りによって自動的にクローズされるため、別途クローズ用URLはありません。シグナルは、利益確定と損切りの値を含む小さなJSONメッセージとして送信されます。

URLはいつでもコピーでき、再生成できます。再生成すると新しいURLが作られ、古いURLは即座に無効になります — URLが漏洩したことがある場合に役立ちます。

#ステップ4：シグナルソースを接続する

Webhook URLをシグナルソースに貼り付けます。例えばTradingViewなら、アラートを作成し、そのWebhook URLをボットのURLに設定します。カスタムシグナルモードでは、エントリーにオープンURL、退出にクローズURLを使います。リスク比率モードでは単一のWebhookを使い、利益確定と損切りをアラートメッセージに含めます。アラート条件がトリガーされると、TradingViewがWebhookを呼び出し、ボットがそれに従って動きます。

#ステップ5：注文設定を行う

ボットが注文のサイズを決め、発注する方法を設定します。カスタムシグナルモードでは、取引金額と、利益確定・損切りを設定します。リスク比率モードでは、代わりに固定リスク額を設定します（取引金額は動的になり、利益確定と損切りはWebhookから来ます）。その後ボットを起動してください — シグナルが届くまで静かに待機し、届いた時点で執行します。

#Webhookを安全に保つ

これはシグナルボットで最も重要な習慣です：あなたのWebhook URLは秘密情報です。 URLを持つ人は誰でも、あなたのボットでその動作をトリガーできます。したがって：

• Webhook URLを公開の場で共有・投稿しないでください。
• ご自身のTradingViewアラートのような、信頼できるツールにのみ貼り付けてください。
• URLが漏洩した疑いがあれば、直ちに再生成してください — 古いURLはただちに機能しなくなります。

#よくある質問

#Freya Financeのシグナルボットとは何ですか？

シグナルボットは、Webhookに送信された外部シグナル — 例えばTradingViewアラート — に基づいて取引を実行します。いつ取引するかをFreyaの中で判断するのではなく、あなたのシグナルを待ち、それを受けて取引所でポジションを開いたりクローズしたりします。すでに別のプラットフォームでシグナルを生成している方に最適です。

#TradingViewをシグナルボットに接続するにはどうすればよいですか？

カスタムシグナルモードを選び、ボットのオープンWebhook URLとクローズWebhook URLをコピーして、TradingViewアラートに貼り付けてください（エントリーにはオープンURL、退出にはクローズURL）。リスク比率モードでは、代わりに単一のWebhook URLを使い、利益確定と損切りをアラートメッセージに含めます。アラートが発火すると、TradingViewがWebhookを呼び出し、ボットが取引します。

#カスタムシグナルモードとリスク比率モードの違いは何ですか？

カスタムシグナルモードでは、ボットはあなたがWebhook経由で送るオープンシグナルとクローズシグナルに従って動き、注文はご自身で設定します — 取引金額と、利益確定・損切りです。リスク比率モードでは、Webhookペイロードが利益確定と損切りの価格を運び（シグナル発火時にエントリーは成行で取られます）、取引金額の代わりに固定リスク額を設定します。するとFreyaがエントリーから損切りまでの距離をもとにポジションサイズを自動で決めるため、ストップアウトのコストは選んだリスク額とほぼ同じになります。2つのモードは組み合わせられません。シグナルの組み立て方に合う方を選んでください。

#リスク比率モードのポジションサイジングはどのように機能しますか？

1取引あたりの固定リスク額を設定します。シグナルが発火すると、Freyaは成行価格でエントリーを取り、Webhookから損切りを読み取り、損切りに達したときの損失があなたが選んだリスク額と等しくなるようにポジションサイズを計算します。これにより、ストップが広くてもタイトでも、1取引あたりのリスクが一定に保たれます — 受け入れる損失額をあなたが決め、サイズがそれに追随します。

#Webhook URLは秘密情報ですか？

はい — パスワードと同じように扱ってください。Webhook URLを持つ人は誰でも、あなたのボットでその動作をトリガーできます。決して共有せず、信頼できるツールにのみ貼り付け、漏洩したと思われる場合は直ちにURLを再生成してください。再生成すると、古いURLはただちに無効になります。

#シグナルを送ったのに何も起きませんでした — なぜですか？

正しいWebhook URL（オープンかクローズか）を使ったか、シグナルモードがアラートの設定方法と一致しているか、ボットが稼働中で一時停止していないかを確認してください。最近URLを再生成した場合は、シグナルソースが新しいURLを使っているか確かめてください。ボットの状態全般については、ボットが取引しないのはなぜ？をご覧ください。

#Webhookで利益確定と損切りを設定できますか？

はい、リスク比率モードを使う場合は可能です。そのモードでは、利益確定と損切りの値をFreyaで手動入力するのではなく、Webhookペイロードから取得します。これにより、外部戦略が退出をコントロールできます。