概要

このリポジトリは「Hyperliquid BTC 極簡フォローボット（V1）」という、Hyperliquid API を利用して指定のターゲットアドレスが保有する BTC 永続（perp）ポジションを自動的に追従（ミラー）するための最小構成スクリプト群です。主に btc_follow_bot_v1.py を中心に、署名処理を担う c_signer.py やアドレス情報の管理用ファイルなどが含まれます。設計は学習／実験用にシンプル化されており、本番運用には不十分な点（例：十分な風控、APIエラーハンドリング、秘密鍵の安全性対策）があるため、実行前にコードレビューと安全対策の実施が必須です。

リポジトリの統計情報

スター数: 10
フォーク数: 0
ウォッチャー数: 10
コミット数: 13
ファイル数: 12
メインの言語: Python

主な特徴

Hyperliquid の API を利用して BTC 永続契約のポジションを自動で追従（フォロー）するサンプル実装。
btc_follow_bot_v1.py によりターゲットアドレスの建玉検出と自動注文を実行。
c_signer.py 等でトランザクション／注文の署名処理を行い、ローカル鍵やキーストアと連携する想定。
学習用途向けの簡潔なコード構成（商用運用向けの安全対策や高度なリスク管理は未実装）。

技術的なポイント

このプロジェクトは「最小限で動く自動フォローボット」を目標としており、設計と実装のポイントは以下です。

API インタラクション: Hyperliquid の REST（あるいは WebSocket）API を叩き、ターゲットアドレスのポジション情報（建玉サイズ、方向、レバレッジ等）を取得して自分の注文に反映します。リアルタイム性を求める場合はポーリング頻度や WebSocket イベント処理の実装が重要になりますが、本実装はまずはシンプルな同期処理で動作することを優先しています。
署名と認証: c_signer.py は注文リクエストに必要な署名作業を担うファイルと推定されます。ローカルの秘密鍵や Keystore（config.json や keystore ファイル）は README に注意点として明記されている通り、コード実行環境の安全性が前提です。署名実装は API 側の要求する形式（例：ECDSA や EdDSA、Payload のハッシュ化など）に従う必要があります。
注文ロジック（ミラーリング）: btc_follow_bot_v1.py はターゲットのポジション満たすために自身のポジションを変更するロジックが中心です。具体的にはターゲットのポジションが増減したら同方向に数量を調整する、もしくはスリッページや手数料を見込んで注文数量をスケーリングする実装が考えられます。ただし README でも説明がある通り、複雑なリスク管理（最大ドローダウンやオフチェーンの資金管理）は実装されていません。
セキュリティとリスク管理の欠如: サンプル実装として「実行前に全コードを読む」「秘密鍵は信頼できる環境でのみ扱う」などの注意喚起が強調されています。自動売買はネットワーク遅延、API レスポンスの変異、ターゲットの意図しないトレードなどで大きな損失を招く可能性があるため、実運用にはログ、監視、フェイルセーフ（例：最大注文サイズ、停止スイッチ）、リプレイ保護、リトライ戦略などの追加が必要です。
実装言語と拡張性: Python ベースでファイル数・コミット数ともに小規模なため、リポジトリは拡張性が高く、例えば WebSocket 対応、非同期処理（asyncio）、注文の部分約定処理への対応やバックテスト機能の追加が容易です。将来的にはロギングとモニタリング（Prometheus / Grafana）、テストスイート（ユニット／統合テスト）の導入を推奨します。

（以上はリポジトリのファイル名と README から読み取れる方針・実装対象に基づく整理です。実際の細かい実装や API パラメータはコードを直接確認してください。）

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: file
README.md: file
addr.md: file
btc_follow_bot_v1.py: file
c_signer.py: file

…他 7 ファイル

各ファイルの役割（推測）

btc_follow_bot_v1.py: メインのフォロー（ミラー）ロジックと API 呼び出しの入口。
c_signer.py: 署名・鍵管理周りのユーティリティ（注文に対する署名生成など）。
addr.md: フォロー対象のアドレスやメモを格納するドキュメント。
README.md: セットアップ方法、注意点、実行前の警告などを記載。

まとめ

ミニマルで学習向けの Hyperliquid ベース BTC フォローボット。安全対策必須。

リポジトリ情報：

名前: hyperliquid-bot
説明: 説明なし
スター数: 10
言語: Python
URL: https://github.com/picasso250/hyperliquid-bot
オーナー: picasso250
アバター: https://avatars.githubusercontent.com/u/1884104?v=4

READMEの抜粋：

🚀 Hyperliquid BTC 极简跟单机器人 (V1)

这是一个基于 Hyperliquid API 的极简跟单机器人脚本，旨在自动跟随指定目标地址的 BTC 永续合约仓位。

🛡️ 极度重要：安全与风险警示

请务必阅读本节。

代码审核 (Code Review): 这是一个自动化交易程序，它将使用您的私钥（或 API 密钥）进行真实的资金交易。在运行任何自动化交易脚本前，您必须完整阅读并理解所有代码（btc_follow_bot_v1.py 和 example_utils.py）的每一行逻辑。
资金安全 (Fund Security): 永远不要在您不信任的机器上运行包含私钥或 Keystore 密码的程序。为了防止恶意攻击和代码植入，请严格保管您的 config.json 或 Keystore 文件。
交易风险 (Trading Risk): 自动化交易存在高风险。本脚本不包含复杂的风控逻辑。您可能因跟单目标决策失误、网络延迟或代码 Bug 而遭受巨大损失。 请仅使…

Hyperliquid BTC シンプルフォローロボット