# Webhook

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

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

近いうちに、ウェブフック経由で動的なシンボル選択、数量、注文タイプ、マルチシンボルロジックなどを含む完全なストラテジー指示をサポートする新しい TradingView Strategy ボットをリリースします — 実質的に API レイヤーとして機能します。ご期待ください

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

### goodcryptoX におけるウェブフックの仕組み

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

こちらはビデオの概要です：

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

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

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

注文やボットを **ウェブフックでトリガーしたい場合**、セットアップ時にトリガー条件としてウェブフックを選択する必要があります **セットアップ中のトリガー条件としてウェブフックを選択してください**。これは以下に適用されます：

* 指値注文のトリガー
* トレーリング注文の発動（トレーリング開始）
* テイクプロフィットおよびストップロストリガー&#x20;
* DCA ボットのエントリー条件

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

<figure><img src="/files/5a358f0087ab8259b4bb34231198e79cead516db" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/1aba421f8f40ceca8a4b468aca7f4f03dd20fe26" alt="" width="375"><figcaption></figcaption></figure>

まとめると：

| アクション                   | サポートされている？ | 注意事項                                     |
| ----------------------- | ---------- | ---------------------------------------- |
| 注文のキャンセル                | ✅          | 詳細に常に表示されます                              |
| 指値注文をトリガー               | ✅          | セットアップ時にウェブフックを選択する必要があります               |
| トレーリング注文を発動             | ✅          | トレーリング開始 = ウェブフック                        |
| テイクプロフィット / ストップロスをトリガー | ✅          | オプションでウェブフックでトリガー可能                      |
| DCA ボット - エントリー         | ✅          | ウェブフックによるエントリー買い/売り（セットアップ時に設定する必要があります） |
| 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の特定のWebhook URLを貼り付ける **利用可能なWebhook** セクション
5. をそのままにしておく **メッセージフィールド** （そのままでも問題ありません — goodcryptoXは現時点でペイロードを無視します）
6. アラートを保存する

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

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

繰り返しのマルチアクション取引をサポートする専用のTradingView戦略ボットを近日導入予定ですが、それまではDCAボットがWebhook駆動の戦略を柔軟に繰り返す方法を提供します。

#### 純粋なWebhookループ

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

1. 設定する **エントリー条件** = webhook
2. 設定する **平均化注文** = 0（平均化を無効）
3. 両方を無効にする **利確（take**-**profit）** と **ストップロス（stop-loss）**
4. を有効にする **「クローズ時に繰り返す」**

<figure><img src="/files/36826839da1d26d42eaaded08ff534ef88874308" alt="" width="375"><figcaption></figcaption></figure>

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

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

**実行ロジック**

* ボットが **Enter Buy**を受信すると、ロングポジションをオープンします。
* ボットは **アイドル状態の間に受け取った最初のエントリWebhookのみに** 応答します。
* ポジションがオープン中:
  * それ以降のエントリシグナルは **無視されます**
  * 受け付けられるシグナルは次のもののみです **ポジションをクローズ** またはトリガーされたTP/SL（設定されている場合）
* ポジションがクローズされると（手動、Webhookによるもの、またはSL/TPによるもの）、ボットはリセットされ次のエントリWebhookを待ちます。

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

#### ピュアWebhookモード vs ハイブリッド構成

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

* **エントリ**：Webhook、シグナル、またはインスタント経由
* **エグジット**：Webhookまたは組み込みの価格ベースのTP/SL経由
* **平均化**：オプション；無効にすることができます

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

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

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

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

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

#### 例1：ワンオフ注文＋複数の利確（ボリンジャーバンド反発）

**目標：** 価格が下部ボリンジャーバンドを割ったときに買い、上昇するにつれて段階的に売る。

**goodcryptoXでの設定**

* トリガー条件＝Webhookの指値注文を作成する
* 3つのテイクプロフィット目標を追加する。TPトリガー＝Webhook

<figure><img src="/files/4df3695fb2665b3d2f9f400e4e6433d6f52d05ed" alt="" width="375"><figcaption></figcaption></figure>

**TradingViewでの設定**

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

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

<figure><img src="/files/fa100232d4406d2117b38abd0f5448b57ec7d6b6" alt="" width="375"><figcaption></figcaption></figure>

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

goodcryptoXの特定のWebhook URLを貼り付ける **利用可能なWebhook** セクション。Messageフィールドはそのままにしてください — 使用されません。

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

**目標：** ゴールデンクロスでロング、デスクロスでショートにエントリ。10％の利益でエグジットするか、RSI > 70のときにエグジットして永遠に繰り返す。

**goodcryptoXでの設定**

DCAボットを作成

* エントリ条件＝Webhook
* 平均化＝オフ（0に設定）
* テイクプロフィット＝10％
* 損切り = オフ
* 有効にする: 「利確で繰り返す」

**TradingViewでの設定**

* 同じチャート上に3つのアラートを作成:
  1. SMA50がSMA200を上抜け → 送信先 **Enter Buy** Webhook
  2. SMA50がSMA200を下抜け → 送信先 **売りを入れる** Webhook
  3. RSI > 70 → 送信先 **ポジションをクローズ** Webhook

### 概要

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goodcrypto.app/goodcryptox-ja/dexsupotto/webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
