# Webhook

goodcryptoXは、TradingViewのウェブフックを介して取引アクションを自動化することを可能にします — シグナルから直接注文やボットのアクションをトリガーする強力な仕組みです。

「buy 3 BTC」のようなパラメータ化されたコマンドを送るプログラマブルなAPIのようにウェブフックを扱う実装もありますが、goodcryptoXは現時点ではトリガーベースのモデルをサポートしています。各ウェブフックは特定の注文やボット上の事前定義されたアクションを単に起動するだけで、パラメータやコマンドは解釈されません。

近い将来、私たちは新しい [TradingView Strategy bot](https://docs.goodcrypto.app/goodcryptox-ja/ppechuaru-dex-1/no/tradingview-botto) を開始します。これは、動的なシンボル選択、数量、注文タイプ、マルチシンボルロジックを含むウェブフック経由の完全なストラテジー指示をサポートし、実質的にAPIレイヤーとして機能します。続報をお待ちください。

> 現時点ではウェブフックはTradingViewのサーバーからのみ受け付けられます — カスタムIPや外部ソースは不可です。\
> カスタムのウェブフック送信元を使用する必要がある場合は、以下までご連絡ください。 <support@goodcrypto.app> でアクセスをリクエストしてください。

### goodcryptoXにおけるウェブフックの動作方法

* 各注文またはボット **アクション** には専用のウェブフックURLがあります
* URLを取得するには、まず注文またはボットを作成する必要があります（それらは **Webhooks** の **詳細**)
* セクションに表示されます）。 **任意の** ウェブフックペイロードをそのURLに送信するとアクションがトリガーされます

> ウェブフックURLはユーザー単位ではなくアクション単位です。アクションごとにウェブフックを1つ作成する必要があります。例えば、エントリー用に1つ、テイクプロフィット用に1つ、ストップロス用に1つなど、各ボットや注文ごとに必要です。

### サポートされている注文およびボットのアクション

注文またはボットを **ウェブフックでトリガーしたい場合**は、セットアップ時にトリガー条件としてウェブフックを選択する必要があります **。**&#x3053;れは次に適用されます：

* ストップマーケット／ストップリミット注文のトリガー
* トレーリング注文の有効化（トレーリング開始）
* テイクプロフィットおよびストップロストリガー&#x20;
* DCAボットのエントリー条件

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

作成後、すべての利用可能なウェブフックURLはあなたの注文またはボットの **詳細** に表示されます：

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

> **キャンセル** ウェブフック — すべての注文とボットで常に利用可能
>
> **ポジションをクローズ** ウェブフック — DCAボットの詳細で常に利用可能

まとめると：

| アクション                 | サポートされている？ | 備考                                         |
| --------------------- | ---------- | ------------------------------------------ |
| 注文をキャンセル              | ✅          | 詳細に常に表示される                                 |
| ストップ注文をトリガー           | ✅          | セットアップ時にウェブフックを選択する必要あり                    |
| トレーリング注文を有効化          | ✅          | トレーリング開始 = ウェブフック                          |
| テイクプロフィット／ストップロスをトリガー | ✅          | オプションでウェブフックによりトリガー可能                      |
| DCAボット - エントリー        | ✅          | Webhook経由でのエントリー買い/売り（セットアップ時に設定する必要があります） |
| DCAボット - 退出           | ✅          | Webhook経由でポジションをクローズ（常に利用可能）               |
| グリッドボット - エントリー       | 🚫         | まだサポートされていません                              |

{% hint style="info" %}
**Webhookによる複数の利確ターゲット**

Webhookをトリガー方法として利確グループを設定すると、すべて同じWebhook URLを共有します。Webhookがトリガーされるたびに、シーケンス内の次のTP注文が順番に実行されます。
{% endhint %}

### TradingViewでアラートを設定する方法

goodcryptoXで注文やボットを作成し、特定のアクション用のWebhook URLをコピーしたら、TradingViewのアラートにリンクする方法は次のとおりです：

1. TradingViewでチャートを開く
2. 戦略、インジケーター、または条件に基づいて新しいアラートを作成する
3. の **アラート設定**で、チェックボックスを有効にします **「Webhook URL」**
4. goodcryptoXのWebhooksセクションから特定のWebhook URLを貼り付ける
5. のままにします **メッセージ欄** をそのままにしてください（内容は何でも構いません — 現時点ではgoodcryptoXはペイロードを無視します）
6. アラートを保存する

### 繰り返し戦略（DCAボット経由）

Webhookでトリガーされる注文（例：TPとSL付きのストップマーケット）は **一度きりの設定**です。一度注文が実行され、連動したTPやSLが発動すると、取引全体は完了します。この構造を **自動的に繰り返したい**場合、注文では不可能ですが、DCAボットを使えば実現できます。

まもなく専用の [TradingView戦略ボット](https://docs.goodcrypto.app/goodcryptox-ja/ppechuaru-dex-1/no/tradingview-botto) を導入して、繰り返しの多アクション取引をサポートする予定ですが、それまではDCAボットがWebhook駆動の戦略を繰り返す柔軟な方法を提供します。

#### 純粋なWebhookループ

Webhookでエントリーし、Webhookで退出し、それを繰り返すボットを設定するには：

1. を設定 **エントリー条件** = webhook
2. を設定 **平均化注文** = 0（平均化を無効化）
3. 両方を無効にする **利確**-**利益** と **ストップロス**
4. を有効にする **「ポジション閉鎖時に繰り返す」**&#x20;

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

ボットを起動すると、ボットの下に次のWebhook URLが表示されます **詳細 → Webhooks** セクション：

* **エントリーバイ** — ロングポジションをオープンします
* **エントリーセル** — ショートポジションをオープンする
* **ポジションをクローズ** — アクティブなポジション（ロングまたはショート）をクローズする
* **キャンセル** — ボットを停止する

**実行ロジック**

* ボットが受信したとき **エントリーバイ**、ロングポジションをオープンします。
* 受信したとき **エントリーセル**、ショートポジションをオープンします。
* ボットは **アイドル状態の間に受信した最初のエントリーWebhookのみに反応します** それを受け取ります。
* ポジションがオープンしている間：
  * それ以降のエントリーシグナルは **無視されます**
  * ボットはエントリーシグナルで現在のポジションを増やしたり反転したりしません
  * 許可される唯一のシグナルは **ポジションをクローズ** またはトリガーされたTP/SL（設定されている場合）です
* ポジションがクローズされると（手動、Webhook、またはSL/TPによって）、ボットはリセットされ次のエントリーWebhookを待ちます。

このループはボットがアクティブである限り続き、エントリー→エグジット→リセットのサイクルを無制限に繰り返すことができます。

#### 純粋なWebhookモードとハイブリッド構成

DCAボットは複数の制御レイヤーをサポートしており、組み合わせて柔軟な戦略を構築できます：

* **エントリー**：Webhook、シグナル、またはASAP経由
* **エグジット**：Webhookまたは組み込みの価格ベースTP/SL経由
* **平均化（Averaging）**：オプション；無効にすることも可能

あなたは次のことができます：

* エントリーとエグジットを含め完全にWebhookシグナルでボットを実行する
* Webhookによるエグジットを使用していても、フォールバックとして価格ベースのTP/SLを追加する
* 追加の保護のために平均化注文を追加する

これにより次の設計が可能になります：

* 完全自動ループ戦略（純粋なWebhook）
* 手動フェイルオーバーを持つシグナル駆動型ボット
* マルチレイヤーのエグジットを持つハイブリッド構成

### 実用的なWebhook戦略の例

#### 例1：ワンオフ注文＋複数のテイクプロフィット（ボリンジャーバンドの反発）

**目標：** 価格が下側のボリンジャーバンドを突破したら買い、上昇するにつれて段階的に売る。

**goodcryptoXでの設定**

* トリガー条件＝Webhookのストップマーケット注文を作成する
* 3つのテイクプロフィットターゲットを追加する。TPトリガー＝Webhook

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**TradingViewでの設定**

4つのアラートを作成する：

1. 価格が下側のバンドを突破 → メイン注文の **トリガー** Webhook URL
2. 価格がバンド内に戻る → 送信先： **テイクプロフィットトリガー** Webhook URL
3. 価格がミッドバンドを横切る → 送信先 **テイクプロフィットトリガー** Webhook URL
4. 価格が上部バンドを突破 → 送信先 **テイクプロフィットトリガー** Webhook URL

<figure><img src="https://2109485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

の **アラート設定**で、チェックボックスを有効にします **「Webhook URL」**

goodcryptoX の Webhooks セクションから特定の webhook URL を貼り付けてください。Message フィールドはそのままにしてください — 使用されません。

#### 例 2: DCA ボットを使った繰り返し戦略（ゴールデンクロス／デスクロス）

**目標：** ゴールデンクロスでロング、デスクロスでショートにエントリー。利確は 10% または RSI > 70 のときに行い、これを永遠に繰り返します。

**goodcryptoXでの設定**

DCA ボットを作成

* エントリー条件 = webhook
* 平均化 = オフ（0 に設定）
* 利確 = 10%
* ストップロス = オフ
* 有効にする: 「TP 時に繰り返す」

**TradingViewでの設定**

* 同じチャート上に 3 つのアラートを作成:
  1. SMA50 が SMA200 を上抜け → 送信先 **エントリーバイ** webhook
  2. SMA50 が SMA200 を下抜け → 送信先 **エントリーセル** webhook
  3. RSI > 70 → 送信先 **ポジションをクローズ** webhook

{% hint style="info" %}
DCA ボットは同時に 1 つのポジションのみ保有します。ポジション保有中は、ポジションがクローズされるまで新しいエントリー webhook を無視します。

同一銘柄でロングとショートを並行してエントリーできるようにするには、2 つの別々のボットを作成し、Enter Buy を一方に、Enter Sell をもう一方に送信してください
{% endhint %}

### 概要

| コンセプト     | 説明                                                |
| --------- | ------------------------------------------------- |
| トリガーモデル   | 各アクションはそれぞれ固有の webhook URL を持ちます                  |
| セットアップの流れ | 注文を作成 → webhook URL をコピー → TradingView のアラートに貼り付け |
| 繰り返し戦略    | 繰り返しを有効にした DCA ボットを使用                             |

### ビデオチュートリアル

#### **webhook トレード入門**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **webhook と DCA ボットの使い方**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **webhook を使った複数利確**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}