# Webhook

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

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

> 近い将来、私たちは新しい [TradingViewストラテジーボット](https://docs.goodcrypto.app/goodcryptox-ja/ppechuaru-dex-1/no/tradingview-botto) をリリース予定で、Webhookを介した完全なストラテジー指示（動的なシンボル選択、数量、注文タイプ、マルチシンボルロジックなど）をサポートし、実質的にAPI層として機能します。続報をお待ちください。

### セキュリティとアクセス

* 現時点ではWebhookはTradingViewサーバーからのみ受け付けます — カスタムIPや外部ソースは不可です。
* カスタムWebhookソースを使用する必要がある場合は、こちらまでご連絡ください： <support@goodcrypto.app> アクセスをリクエストしてください。
* WebhookはアクティブなPRO [プラン](https://docs.goodcrypto.app/goodcryptox-ja/ekoshisutemu/sabusukuripushonpuran) 以上のユーザーのみ利用可能です。

### goodcryptoXにおけるWebhookの仕組み

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

> Webhook URLはユーザー固有ではなくアクション固有です。アクションごとに1つのWebhookを作成する必要があります。例えば、各ボットや注文ごとにエントリー用、利確用、ストップロス用などをそれぞれ作成してください。

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

注文やボットを **Webhookでトリガーしたい場合**は、設定時にトリガー条件としてWebhookを選択する必要があります **。**&#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>

作成後、利用可能なすべてのWebhook 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>

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

まとめると：

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

{% hint style="info" %}
**ウェブフックによる複数の利確ターゲット**

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

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

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

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

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

ウェブフックでトリガーされる注文（例：TPとSL付きのストップマーケット）は、 **一回限りの設定**です。注文が実行され、関連するTPまたはSLが発動すると、取引は完了します。この構成を **自動的に繰り返す**ことは注文ではできませんが、DCAボットを使用すれば現在実現可能です。

近いうちに専用の [TradingView戦略ボット](https://docs.goodcrypto.app/goodcryptox-ja/cex-qu-yin/no/tradingview-botto) を導入して、繰り返しのマルチアクション取引をサポートする予定ですが、それまではDCAボットがウェブフック駆動の戦略を繰り返す柔軟な方法を提供します。

#### 純粋なウェブフックループ

ウェブフックでエントリー、ウェブフックでエグジットし、それを繰り返すボットを設定するには：

1. 設定する **エントリー条件** = ウェブフック
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>

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

* **買いを入力** — ロングポジションを開きます
* **売りを入力** — ショートポジションを開きます
* **ポジションをクローズ** — アクティブなポジション（ロングまたはショート）をクローズします
* **キャンセル** — ボットを停止します

**実行ロジック**

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

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

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

DCAボットは、柔軟な戦略を構築するために組み合わせ可能な複数の制御レイヤーをサポートします：

* **エントリー**：Webhook、シグナル、またはASAP経由
* **エグジット**：Webhookまたは組み込みの価格ベースのTP/SL経由
* **平均化（アベレージング）**：任意；無効にすることができます

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

* 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%
* 損切り = オフ
* 有効にする: 「利確時に繰り返す」

**TradingViewでの設定**

* 同じチャート上にアラートを3つ作成:
  1. SMA50 が SMA200 を上抜け → 宛先へ送信 **買いを入力** webhook
  2. SMA50 が SMA200 を下抜け → 宛先へ送信 **売りを入力** webhook
  3. RSI > 70 → 宛先へ送信 **ポジションをクローズ** webhook

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

同一銘柄でロングとショートを並行して取れるようにしたい場合は、2つの別々のボットを作成し、片方にエントリーバイを、もう片方にエントリーセルを送信してください
{% endhint %}

### 概要

| コンセプト     | 説明                                               |
| --------- | ------------------------------------------------ |
| トリガーモデル   | 各アクションごとに専用の webhook URL がある                     |
| セットアップの流れ | 注文を作成 → webhook URL をコピー → TradingView アラートに貼り付け |
| 繰り返し戦略    | 繰り返し有効の DCA ボットを使用                               |
| アクセス      | PRO プラン以上が必要                                     |

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

#### **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>" %}