find-xemm-opps

find-xemm-opps

接続された取引所間のオーダーブックの厚みと流動性を分析して、クロス取引所マーケットメイキング（XEMM）の機会を見つけます。

XEMM では、ある取引所でクォートを出し（メイカー側）、別の取引所で約定をヘッジします（テイカー/ヘッジ側）。最良の機会が存在するのは次の条件が揃う場所です：

• ある取引所が広いスプレッドと薄い板を持つ（メイカー側 — 有利にクォートを出せる余地がある）
• 別の取引所が狭いスプレッドと厚い板を持つ（テイカー側 — 安価にヘッジできる）
• 両者の間にミッドプライス差が存在する

前提条件

Hummingbot API が取引所コネクターを設定した状態で実行されている必要があります：

bash <(curl -s https://raw.githubusercontent.com/hummingbot/skills/main/skills/lp-agent/scripts/check_prerequisites.sh)

ワークフロー

ステップ 1: トークンペアを定義する

# Scan for SOL/USDT XEMM opportunities
python scripts/find_xemm_opps.py --base SOL --quote USDT

# Include fungible equivalents
python scripts/find_xemm_opps.py --base ETH,WETH --quote USDT,USDC

# Filter to specific connectors
python scripts/find_xemm_opps.py --base BTC --quote USDT --connectors binance,kraken,coinbase,okx

# Minimum mid-price spread between exchanges (default: 0.0%)
python scripts/find_xemm_opps.py --base SOL --quote USDC --min-spread 0.05

ステップ 2: 結果を解釈する

スクリプトはマーケット概要テーブルと、ランク付けされた XEMM 機会ペアを出力します：

====================================================================
  XEMM Opportunities — SOL / USDC
  Order book depth: 20 levels | Sources: 18
====================================================================

  Exchange               Pair            Mid     Spread    Bid Depth    Ask Depth    B/A
  ---------------------- -------------- ---------- -------- ------------ ------------ ------
  bitstamp               SOL-USDC         $87.45   0.120%       $23.4K       $18.9K   1.24
  binance                SOL-USDT         $87.51   0.015%      $412.0K      $389.0K   1.06
  okx                    SOL-USDT         $87.56   0.023%      $287.0K      $301.0K   0.95
  ...

  Top XEMM Opportunities (MAKER → hedge on TAKER):
  ----------------------------------------------------------------

  #1  Score: 8.42
      MAKER  bitstamp               $87.45  spread 0.120%  depth $42.3K
      TAKER  binance                $87.51  spread 0.015%  depth $801.0K
      Mid-price gap: 0.0686%  |  Spread ratio: 8.0x  |  Depth ratio: 18.9x

列の説明:

列	説明
Mid	最良買値と最良売値の間のミッドプライス
Spread	ミッドプライスに対する売買スプレッドの %
Bid/Ask Depth	上位 N 段のオーダーブックレベルのクォート価値の合計
B/A	買値と売値の厚みの比率（1 超 = 買い圧力が強い）
Spread ratio	メイカーのスプレッド ÷ テイカーのスプレッド — 高いほどメイカーの優位性が大きい
Depth ratio	テイカーの厚み ÷ メイカーの厚み — 高いほどヘッジ流動性が高い

スクリプトオプション

オプション	説明
--base	ベーストークン（カンマ区切り、例: ETH,WETH）
--quote	クォートトークン（カンマ区切り、例: USDT,USDC）
--connectors	特定のコネクターに絞り込む（任意）
--depth	取引所ごとのオーダーブックの厚み（デフォルト: 20）
--min-spread	取引所間のミッドプライススプレッドの最小 %（デフォルト: 0.0）
--include-btc-markets	btc_markets を含める（オーストラリア居住者限定）
--include-ndax	ndax を含める（カナダ居住者限定）
--json	JSON として出力する

環境変数

export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin

スクリプトは次の場所で .env を探します: ./hummingbot-api/.env → ~/.hummingbot/.env → .env

要件

• Hummingbot API が実行されていること
• API キーが設定された取引所コネクターが少なくとも 2 つあること