Claude CodeでHyperliquid自動売買ボットを作る完全手順【2026年版】Python SDK・ファンディング収益・ポジション管理まで

取引量世界第1位のパープDEX「Hyperliquid」には、公式Python SDKと充実したAPIが整備されており、Claude Codeを使えばプログラミング初心者でも数時間で自動売買ボットを構築できます。

本記事では「Hyperliquidのボットを作りたいけど何から始めればいい？」という疑問を解消します。環境構築から実際のコード生成・テスト・本番稼働まで、Claude Codeとの対話ログを交えて完全解説します。

---

なぜClaude Code × Hyperliquidなのか？

Hyperliquidが選ばれる3つの理由

2026年5月時点でHyperliquidはDeFiLlamaの月間パープDEX取引量で世界第1位（$185B超）を維持しています。個人トレーダーから機関投資家まで、なぜHyperliquidを選ぶのでしょうか。

Claude Codeが自動売買開発を革命的に変える

従来、ボット開発には数週間〜数ヶ月のプログラミング学習が必要でした。Claude Codeを使えば、「ファンディングレートが0.05%を超えたらBTCをショート、0.01%を下回ったらクローズするボットを作って」という日本語の指示だけでコードが生成されます。

• Hyperliquid Python SDKの使い方をClaudeが熟知しており、正確なコードを生成
• エラーが出てもClaudeがデバッグ・修正まで対応
• テストネットでの動作確認→本番移行の手順も指示通りに進む

---

Step 1：環境構築

必要なもの

Python SDKのインストール

プロジェクトフォルダを作成してSDKをインストールします。

# プロジェクトフォルダ作成
mkdir hl-bot && cd hl-bot

# 仮想環境作成（推奨）
python -m venv venv
source venv/bin/activate  # Mac/Linux
# venv\Scripts\activate  # Windows

# Hyperliquid Python SDK インストール
pip install hyperliquid-python-sdk

# その他必要なライブラリ
pip install python-dotenv requests

APIウォレットの設定（推奨）

Hyperliquidのボット運用には、メインウォレットの秘密鍵を直接使う方法と、専用のAPIウォレットを生成する方法があります。セキュリティ上、APIウォレットを強く推奨します。

1. Hyperliquid UIにアクセスし Settings → API を開く
2. 「Generate API Wallet」をクリック → 新しいウォレットアドレスと秘密鍵が生成される
3. メインウォレットで署名して APIウォレットに権限を付与
4. APIウォレットに少額のUSDCを転送してテスト

設定ファイル（.env）を作成します。

# .env（Gitにコミットしない！）
HL_ACCOUNT_ADDRESS=0xあなたのウォレットアドレス
HL_SECRET_KEY=0xあなたのAPIウォレット秘密鍵
HL_USE_TESTNET=true  # テスト中はtrue、本番はfalse

---

Step 2：Claude Codeを起動してボットを生成する

Claude Codeの起動

cd hl-bot
claude

基本ボットのコード生成（プロンプト例）

Claude Codeに以下のように指示します。

生成されるコードの解説

Claude Codeが生成するコード（funding_bot.py）の主要部分を確認します。

import os, time, logging, math
from dotenv import load_dotenv
from hyperliquid.info import Info
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
from eth_account import Account

load_dotenv()

# ── 設定 ──────────────────────────────
ACCOUNT  = os.getenv("HL_ACCOUNT_ADDRESS")
SECRET   = os.getenv("HL_SECRET_KEY")
TESTNET  = os.getenv("HL_USE_TESTNET", "true").lower() == "true"
BASE_URL = constants.TESTNET_API_URL if TESTNET else constants.MAINNET_API_URL

COIN            = "BTC"
ENTRY_THRESHOLD = 0.0005   # ファンディング +0.05% でショートエントリー
EXIT_THRESHOLD  = 0.0001   # ファンディング +0.01% でクローズ
MARGIN_RATIO    = 0.20     # 証拠金の20%を使用
LEVERAGE        = 3        # 3倍レバレッジ
BTC_MIN_SZ      = 0.001    # BTC最小発注量

# ── ロギング設定 ───────────────────────
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s %(levelname)s %(message)s",
    handlers=[
        logging.FileHandler("bot.log"),
        logging.StreamHandler()
    ]
)
log = logging.getLogger(__name__)

# ── SDK初期化 ──────────────────────
wallet   = Account.from_key(SECRET)
info     = Info(BASE_URL, skip_ws=True)
exchange = Exchange(wallet, BASE_URL, account_address=ACCOUNT)

def get_funding_rate(coin: str) -> float:
    """現在のファンディングレートを取得"""
    meta     = info.meta_and_asset_ctxs()
    universe = meta[0]["universe"]
    ctxs     = meta
    for i, asset in enumerate(universe):
        if asset["name"] == coin:
            return float(ctxs[i]["funding"])
    return 0.0

def get_position(coin: str):
    """現在のポジションを取得（szi=0のクローズ済みは除外）"""
    state = info.user_state(ACCOUNT)
    for pos in state["assetPositions"]:
        if pos["position"]["coin"] == coin:
            if float(pos["position"]["szi"]) != 0:   # ← szi=0除外（バグ2修正）
                return pos["position"]
    return None

def get_usdc_balance() -> float:
    """証拠金残高を取得"""
    state = info.user_state(ACCOUNT)
    return float(state["marginSummary"]["accountValue"])

def main():
    log.info(f"ボット起動 | {'\u30c6\u30b9\u30c8\u30cd\u30c3\u30c8' if TESTNET else '\u672c\u756a'} | {COIN}")
    while True:
        try:
            rate    = get_funding_rate(COIN)
            pos     = get_position(COIN)
            balance = get_usdc_balance()
            log.info(f"ファンディング: {rate*100:.4f}% | 残高: ${balance:.2f}")

            # エントリー条件：ファンディング高＋ポジションなし
            if rate >= ENTRY_THRESHOLD and pos is None:
                mid_price = float(info.all_mids().get(COIN, 0))  # ← 文字列→float変換（バグ1修正）
                if mid_price == 0:
                    log.warning(f"{COIN}の価格取得失敗 → スキップ")
                    time.sleep(3600)
                    continue
                sz = (balance * MARGIN_RATIO * LEVERAGE) / mid_price
                sz = math.floor(sz * 10**5) / 10**5  # ← floor+5桁精度（バグ2修正）
                if sz < BTC_MIN_SZ:                   # ← 最小発注量チェック（バグ4修正）
                    log.warning(f"発注量 {sz} BTC が最小サイズ未満（最小: {BTC_MIN_SZ} BTC）→ スキップ")
                    time.sleep(3600)
                    continue
                result = exchange.market_open(COIN, False, sz)  # False=Short
                log.info(f"ショートエントリー {sz} BTC | 結果: {result}")

            # クローズ条件：ファンディング低下＋ポジションあり
            elif rate < EXIT_THRESHOLD and pos is not None:
                result = exchange.market_close(COIN)
                log.info(f"クローズ | 結果: {result}")

        except Exception as e:
            log.error(f"エラー: {e}")

        time.sleep(3600)  # 1時間待機

if __name__ == "__main__":
    main()

---

Step 3：テストネットで動作確認

テストネット用USDCの取得

テストネットで動かすには、テスト用USDCが必要です。

1. Hyperliquid テストネット（app.hyperliquid-testnet.xyz）にアクセス
2. MetaMaskをArbitrum Sepoliaテストネットに切り替え
3. 「Deposit」から 「Testnet USDC」を取得（フォーセットから無料取得可）

ボットの起動と確認

# テストネットで起動（.envのHL_USE_TESTNET=true を確認）
python funding_bot.py

# ログ出力例
# 2026-05-27 10:00:01 INFO ボット起動 | テストネット | BTC
# 2026-05-27 10:00:02 INFO ファンディング: +0.0312% | 残高: $1000.00
# 2026-05-27 11:00:01 INFO ファンディング: +0.0521% | 残高: $1000.00
# 2026-05-27 11:00:02 INFO ショートエントリー 0.0063 BTC | 結果: {'status': 'ok', ...}

---

Step 4：応用パターン——WebSocketでリアルタイム対応

WebSocketサブスクリプション一覧

1時間ごとのポーリングより、WebSocketのリアルタイムストリームを使うとより精度の高いボットになります。

TWAPオーダーによる大口注文の分割

一度に大量のBTCを注文するとスリッページが発生します。HyperliquidのTWAPオーダーは30秒ごとに自動分割して約定し、スリッページを3%以内に制御します。

---

Hyperliquid 手数料ティアとコスト最適化

HYPEステーキングによる手数料割引

$HYPEトークンをステーキングすると、手数料に割引が適用されます。

• 10 HYPE ステーク（Wood）：手数料 5% OFF
• 100 HYPE ステーク（Bronze）：手数料 10% OFF
• 1,000 HYPE ステーク（Silver）：手数料 15% OFF
• 10,000 HYPE ステーク（Gold）：手数料 20% OFF

$HYPEはBitgetで購入可能です。Hyperliquidに送金してステーキングすることで即時割引が適用されます。

---

注文タイプ別 Claude Codeへの指示テンプレート

ボットに実装したい機能を日本語で指示するためのテンプレートです。

---

よくある質問（FAQ）

---

まとめ

Claude CodeとHyperliquid Python SDKを組み合わせれば、プログラミング初心者でも1日以内に自動売買ボットを稼働させることができます。

月間取引量世界1位のHyperliquidで自動売買を動かし、ファンディングレートの収益を積み上げましょう。まずはBitgetでUSDCかHYPEを購入して、Hyperliquidへの入金から始めてください。