Polymarket コピー・トレーダー(自動模倣ボット)
概要
Polymarket の上位ランクウォレット(ランキング上位のトレーダー)を追尾して、同様の売買を自分のプロキシウォレットで自動的に再現(コピー)するための Python ボットです。ユーザーは自身のプロキシウォレットアドレスと事前に作成した API キー、及び該当ウォレットでのトークン許可(allowance)を設定しておく必要があります。シンプルな使い方(main.py の実行)を想定しており、キャップストーンプロジェクトとしてのドキュメントやプレゼン資料も含まれています。実運用では API レート制限、ガス代、秘密鍵管理などの注意点が重要になります。
リポジトリの統計情報
- スター数: 53
- フォーク数: 2
- ウォッチャー数: 53
- コミット数: 30
- ファイル数: 17
- メインの言語: Python
主な特徴
- Polymarket の上位ウォレットの月次トレードを検出して追尾(tailing)する自動化ロジック
- プロキシ(代理)ウォレットでの取引実行を想定した設計(API キーとウォレット許可が必要)
- シンプルな実行フロー:設定を入力して main.py を走らせるだけの使い勝手
- キャップストーン資料(プレゼン・要件表)が同梱され、学術/教材用途にも適する
技術的なポイント
このプロジェクトは、オンチェーン情報の取得とウォレット操作を組み合わせた典型的な「コピー・トレード」ボットの構成を持ちます。README とファイル構成から推測される実装上の要点は以下の通りです。
- データ取得:Polymarket のパブリック API(またはスクレイピング相当)から、ランキング上位ウォレットのトレード履歴や現在のポジションを定期的に取得する仕組みがあります。月次での対象選定と最新トレードの差分検出がコアロジックです。
- トランザクション実行:取得したトレードを「プロキシウォレット」で模倣するため、Ethereum 系のトランザクション生成・署名が必要になります。実装では Web3.py 等のライブラリを用いる想定で、秘密鍵管理や nonce、ガス価格の調整などを考慮する必要があります。
- 認証・権限管理:README にあるように API キーの準備とプロキシウォレットに対するトークンの allowance 設定が前提です。これにより、トークン移転やポジション建て直しが可能になりますが、権限の与え方は最小化することが重要です。
- エラーハンドリングと再試行:外部 API のレート制限、ノード接続の不安定さ、オンチェーンの失敗(ガス不足やリバート)を考慮した堅牢な再試行ロジックとログ記録が望まれます。ログはトランザクションハッシュや失敗理由を追跡できる形式が有用です。
- 運用面の配慮:秘密鍵は環境変数やシークレットマネージャで管理し、コードベースに含めないこと。実行は仮想環境で dependencies を固定(requirements.txt)し、CI/CD での自動テストやステージング用ネットワーク(Testnet)での検証を推奨します。
- 拡張性:対象ウォレットの選定アルゴリズム(例:月間 PnL、取引頻度、成功率)をパラメタライズすることで、単純な「全コピー」からよりスマートなミラートレード戦略へ発展させられます。また、ガス節約のためのバッチ処理、スリッページ制御、最大投入額などリスク管理機能の追加も現実運用では重要です。
- ドキュメントと教育リソース:Capstone Presentation や要件 Excel が同梱されており、プロジェクトの目的、要件定義、デモ手順が整理されています。学術的なプロジェクトとして再現性と説明責任を重視している点が評価できます。
実際に導入する際は、法規制や取引所/プロトコルの利用規約、倫理面(他者の取引を模倣する影響)も確認した上で運用設計を行ってください。
プロジェクトの構成
主要なファイルとディレクトリ:
- .github: dir
- .gitignore: file
- Capstone Presentation.pptx: file
- Capstone Requirements Excel.xlsx: file
- README.md: file
- main.py: file (README に記載されたエントリポイント) …他 12 ファイル
まとめ
教育目的と実践的検証を両立した Polymarket 用コピー・トレードのプロトタイプ。運用前のセキュリティ・法務検討が必須。
リポジトリ情報:
- 名前: polymarket_copy_trader
- 説明: An automated bot for tailing the trades of the top ranked wallets on Polymarket monthly
- スター数: 53
- 言語: Python
- URL: https://github.com/megyerikenez/polymarket_copy_trader
- オーナー: megyerikenez
- アバター: https://avatars.githubusercontent.com/u/61545987?v=4
READMEの抜粋:
polymarket_copy_trader
An automated bot for tailing the trades of the top ranked wallets on Polymarket monthly
- Simple Usage: enter your Polymarket Proxy Wallet Address, run main.py
- Note: You will need to have previously created API Keys and set allowances for your proxy wallet address
Project Setup
This guide will help you set up the project environment using the provided requirements.txt file.
Prerequisites
- Python installed on your machine.
- A virtual environment (recommend…