トピック
    BybitにおけるWebhookシグナル取引の設定・利用方法
    bybit2025-07-10 13:00:24
    ステップバイステップガイドよくある質問(FAQ)

    免責事項:この記事は機械翻訳によって日本語に仮翻訳された記事です。改訂版は後日公開される予定です。

     

     

     

    BybitのWebhookシグナル取引は、TradingViewからのシグナルを使用して無期限契約や先物契約の自動取引を可能にする強力なツールです。TradingViewのWebhook機能を活用すると、アラートが発動するたびに特定のURLにリクエストを送信し、取引プロセスを自動化できます。

     

     

     

    Webhookシグナル取引のご利用前に、以下の重要な注意事項をご確認ください。

    — Webhookを使用するには、TradingViewの有料プラン(Essential/Plus/Premium)を契約している必要があります。

    — WebhookのURLは絶対に第三者と共有しないでください。共有した場合、偽メッセージや詐欺メッセージを受信したり、第三者からの不正な注文を受け取ったりする可能性があります。

    — 受信するTradingViewアラートはすべて、お客様の設定に応じて送信されており、Bybitはそれに起因する取引損失の責任を負いません。

    — シグナルのトリガーについてはサードパーティのプラットフォームに依存しているため、シグナルの消失や遅延のリスクがある点にご注意ください。

    — この機能は、Bybit公式ウェブサイトでのデリバティブ取引(USDT無期限、USDC無期限、インバース無期限、インバース型先物契約など)に限り利用可能です。また、統合取引アカウントに資金を用意しておく必要があります。




    以下のセクションでは、BybitにおけるWebhookシグナル取引の設定・利用方法について、順を追ってご説明します。開始前に、アカウントに十分な資金があることをご確認ください。







    Webhookを作成する

    ステップ1:「取引」タブで、取引したい契約のページに移動します。注文ゾーンで「ツール」をクリックし、「Webhookシグナル取引」を選択します。

     






    ステップ2:「今すぐ作成」をクリックします。作業を進めるには、この機能の概要を理解する必要があります。Webhookシグナル取引の実行方法については、チュートリアル動画をご覧ください。その後、「上記を確認しました」をクリックしてください。

     






    ステップ3:以下の手順に従ってWebhookを設定してください。

    1. シンボルの選択:Webhook取引に使用したいシンボルを選択します。この説明が、TradingViewで戦略に使用するシンボルと一致していることを確認してください。
    2. ポジションモード:ワンウェイモードにします。戦略の実行に使用するシンボルのポジションモードが「ワンウェイ」モードに設定されていることを確認してください(「ヘッジポジション」モードでは自動取引がサポートされていません)。
    3. シグナル名:TradingView戦略のシグナル名を入力します。

     

    「Webhookを作成」をクリックします。

     

     

    — Webhookシグナル取引は「ワンウェイ」ポジションモードでのみサポートされています。戦略スクリプトが「ヘッジポジション」モードに依存していないことを確認してください。

    — Webhookは通貨ペアごとに作成する必要があります。



    これで、Webhookを作成できました。








    TradingViewでの戦略実行

    ステップ1:Webhookの作成後は以下各契約をクリックして、TradingViewで戦略を実行します(必要な場合)。

     






    ステップ2:TradingViewページで「ストラテジーテスター」をクリックし、戦略を読み込みます。

     

    Webhookシグナル取引は戦略の実行のみを目的としており、指標には対応していないことにご注意ください。チャートで指標と戦略のどちらが使用されているかを確認するには、Pine Scriptソースコードの最初のセグメントをご覧ください。「Strategy(戦略)」と書かれていれば、戦略が使用されています。一方、「Indicator(指標)」と書かれていれば、指標がチャートで使用されています。

     






    ステップ3:戦略の設定を開き、以下のようにパラメータを設定します。

    • Bybitアカウント残高への初期資金額を設定します。
    • 注文ごとの希望数量を入力します。シグナルを受信した後に、その数量で注文が発注されます。

     

    — インバース契約では、現在、契約単位での注文サイズのみがサポートされています。USDまたは保有資産の比率で注文サイズを入力すると、注文建てに失敗する可能性があります。これは、TradingViewとBybitで契約価額の計算ロジックが異なるためです。

    — 契約単位で注文サイズを入力する場合、インバース契約における1契約あたりの単位は1 USDとなります。一方で、USDTまたはUSDC契約の場合は、BTCUSDTとBTC-PERPを例にとると、1契約あたりの単位は1BTCとなることにご注意ください。

     

     

     

     

     

     

    ステップ4:戦略アラートを作成します。

     

    パラメータ

    説明

    シンボル

    TradingViewから{{ticker}}

    アラートのシンボル

    サイド

    • TradingViewから{{strategy.order.action}}

    • ENTER_LONG

    • 終了_ロング

    • ENTER_SHORT

    • 終了_ショート

    一方向モードのみ対応しています。ドロップダウンから注文のサイドを選択できます。

     

    取引ビュー側は、一定の取引方向がないことを意味します。注文は取引ビュー戦略の方向に基づいて発注されます。

     

    トリガー時間

    TradingViewから{{timenow}}

    アラートがトリガーされた時刻です。このパラメータを変更する必要はありません。

    戦略ID

    シグナルトリガー時にBybitが作成

    このWebhookアラートの戦略ID

    金額タイプ

    • 絶対数量

    • ポジション比率

    • Webhook設定ページで金額タイプを選択するか、Tradingviewに貼り付けたテンプレートから直接パラメータ値を編集できます。

    • 金額タイプはオプションで、デフォルトで絶対値(value=absolute.quantity)に設定されています。

    • 絶対値とは、Webhookが設定した数量に基づいて発注することを意味します。

    • ポジション%(value=position.percentage)の選択は、終了注文でのみ可能です。選択した未決済ポジションの割合に基づいて、ポジションが決済されます。

     

    数量

    • strategy.order.contracts

    • 契約数量

    • ポジションの割合

    • 設定された数量が{{strategy.order.contracts}}の場合、WebhookはTradingviewの設定に基づいて注文を行います。

    • テンプレート自体に特定の数量を入力することもできます。これにより、元のシグナルが上書きされます。たとえば、「Quantity」を設定した場合、BTCを例にとります。「」1「」を USDT/USDC契約の場合、1契約は1 BTCに相当します。インバース契約の場合、1契約は1 USDに相当します。

    • 選択した金額タイプがポジションの割合である場合、設定された数量は、決済したいポジションの割合で、[0.01, 100] ~ %の範囲になります。決済率は、常にトリガー時のポジションサイズに基づきます。

    価格

    トレードビュー戦略からのトリガー価格

    これは、アラートがトリガーされた価格の結果です。このパラメータを変更する必要はありません。

    最大遅延

    [5, 300]の負でない整数値。

    これは、お客様が承諾できる最大シグナルレイテンシーです。デフォルトでは、20秒に設定されています。遅延が設定した範囲を超えた場合、Webhookは注文を行いません。

     

     

     

     

     

     

    ステップ5:ストラテジーテスターの「アラート」アイコンをクリックし、戦略のアラートを作成します。その後、アラートのポップアップウィンドウでメッセージテンプレートとWebhook URLを貼り付けます。

     

     

    注:

    — Bybitページからメッセージテンプレートをコピーし、アラート設定タブのメッセージボックスに貼り付けることができます。

     

     

    WebhookのURLはBybitページにあり、アラート通知タブのWebhookのURLフィールドに貼り付ける必要があります。

     

     

     

     

     

     

    ステップ6:シグナルがトリガーされた後に注文タイプを設定し、設定する場合はTPL/SLを設定します。

    • 注文タイプ: 市場注文または指値注文を設定できます。アラートがトリガーされると、それぞれの注文が発注されます。指値注文の場合、指値注文価格としてトリガーする距離を設定する必要があります。

      • ロング:指値 = シグナルトリガー価格 × (1 - トリガーまでの距離)

      • ショート:指値 = シグナルトリガー価格 × (1 + トリガーまでの距離)

    • 利食い/損切り: 利食/損切注文は、入金額注文の実行時に発注されます(出金注文はサポートされていません)。利食いと損切りの数量は、各シグナルのサイズに基づきます。利食いまたは損切りを設定でき、注文が発注されたら、ポジションタブから希望に応じて価格を編集できます。価格は、そのシグナルの参入価格に基づいて計算されます。

      • ロング利食いトリガー価格:シグナルエントリー価格 × (1 + 価格変動%)

      • ショート利食いトリガー価格:シグナルエントリー価格 × (1 - 価格変化率 %)

      • ロングSLトリガー価格:シグナルエントリー価格 × (1 - 価格変化率 %)

      • ショートSLトリガー価格:シグナルエントリー価格 × (1 + 価格変動%)

     

     

     

     

     

     

    ステップ7:「Webhookを実行」をクリックします。

     



    これでシグナル取引の設定が完了しました。戦略シグナルのプッシュ通知が、Bybitアプリやブラウザに送信されるようになります。








    シグナルの詳細表示

    Webhookシグナルの詳細を表示するには、「ツール」タブを開いて「Webhook」を選択します。シグナル名、トリガー回数/取引回数、実現損益、作成時間を確認できます。

     



    シグナルの詳細情報をさらに表示するには、横にある「詳細」ボタンをクリックします。Webhook URLとメッセージテンプレートを確認できます。また、この戦略で約定した取引も表示されます。

     



    「Webhook戦略」タブに表示される実現損益は、各Webhook戦略で約定した取引の実現損益であることにご注意ください。手動取引により生じた損益は、ここには表示されません。



    または、ツール履歴」→「ツールの種類」「Webhook」を選択し、詳細を表示することもできます。

     








    Webhookシグナルの終了

    手動での終了または一時停止:Webhookシグナルを手動で終了するには、「ツール」タブに移動し、終了したいWebhookによって開始されたシグナルを探して「終了」をクリックします。戦略を一時的に停止する場合は、「一時停止」をクリックします。

     




    自動終了:Webhookシグナルは、以下のような理由で自動的に終了する場合があります。

    1. 10回連続して注文に失敗した場合。
    2. 選択した契約タイプがTradingViewでサポートされていない場合。
    3. パラメータの設定が不完全な場合。
    4. サポートされていないポジションモード(ヘッジモード)が選択されている場合。
    5. 選択した先物契約の受渡日が近づいている場合。
    6. Webhook戦略の数が作成可能な上限に達した場合。各シンボルでは5件のWebhook戦略を同時に実行可能で、各UIDは最大30件のWebhook戦略を同時に実行できます。
    7. アカウントが制限されている場合。








    注文制限

    Webhook戦略で発注する注文には、無期限・先物取引の手動取引に関する注文制限がすべて適用されることにご注意ください。これには、最小・最大注文サイズ、契約価格制限などが含まれます。

     

    Webhook戦略での注文は、以下の理由により失敗する場合があります。

     

    エラーメッセージ

    説明

    シグナルの遅延により、注文ができませんでした。

    シグナルの転送が遅延しており、注文が発注されて約定した場合に、シグナルが戦略と一致しない可能性があります。そのため、注文はキャンセルされます。

    シンボルが無効だったため、注文ができませんでした。

    戦略で指定された通貨ペアは、Bybitではサポートされていないか、上場廃止となっています。

    パラメータの不足により、注文ができませんでした。再度メッセージテンプレートをコピーしてご利用ください。

    パラメータ設定が不完全です。Webhookを再実行してください。

    利用可能残高が不足していたため注文に失敗しました。

    注文発注に必要な証拠金が不足しています。統合取引アカウントに資金を追加してください。

    ポジションモードが一致しないため注文に失敗しました。

    Webhookシグナル取引はワンウェイポジションモード以外ではサポートされていません。ポジションモードがヘッジモードに変更されており、注文の発注に失敗しました。

    リスク制限を超えるため注文に失敗しました。

    注文が発注されると、リスク制限が現在設定されている階層を超えてしまいます。取引設定でリスク制限を調整できます。

    受渡日が近い契約ではリデュースオンリー注文のみ発注可能です。

    先物契約の受渡日が近づいているためオープン注文は発注できません。

    未決済建玉制限を超えるため注文に失敗しました。

    注文が発注されると、未決済建玉制限を超過することになります。

    役に立ちましたか?
    yesはいyesいいえ