Papertrade AI

https://papertrade-ai.ninabrekkerese.workers.dev/mcp

URLは1つ、OAuth 2.1に対応し、APIキーは不要です。ウォレットで一度署名すると、取引はできても出金はできないセッションキーが登録されます。さらにサーバーは、取引ごとの証拠金、レバレッジ、1日の取引量、保有ポジション数、市場など、選択した制限を適用します。すべての取引は事前にプレビューされ、実行には確認が必要です。

質問できること

• 「PapertradeのBTCとETHは今どうなっていますか？」
• 「PapertradeのETH清算マップを見せてください。」
• 「今週のPapertrade上位10人のトレーダーは誰ですか？何を保有していますか？」
• 「ウォレット0x...を分析してください。勝率、最大の取引、エクイティカーブを教えてください。」
• 「500倍のレバレッジで20ドル分のBTCをロングした場合、清算価格はいくらですか？」
• 「800倍のレバレッジで15ドル分のETHをショートする取引をプレビューして、私が確認したら実行してください。」
• 「BTCのポジションをすべて決済してください。」

MCP Appsに対応したクライアント（Claude、ChatGPT、VS Code、Goose）では、ライブチャート付きのインタラクティブな取引カードとして結果が表示されます。

インストール

クライアント	インストール
Claude（ウェブ、デスクトップ、モバイル）	設定、コネクタ、カスタムコネクタを追加の順に選択し、https://papertrade-ai.ninabrekkerese.workers.dev/mcpを貼り付けます。ガイド
Claude Code	/plugin marketplace add nirholas/papertrade-aiの後に/plugin install papertrade-ai@papertrade-aiを実行するか、claude mcp add --transport http papertrade https://papertrade-ai.ninabrekkerese.workers.dev/mcpを実行します。ガイド
ChatGPT	設定、アプリ、詳細設定、開発者モードの順に選択し、アプリを作成してURLを貼り付け、OAuthを設定します。ガイド
OpenAI Codex	codex mcp add papertrade --url https://papertrade-ai.ninabrekkerese.workers.dev/mcpの後にcodex mcp login papertradeを実行します。ガイド
Cursor	ワンクリックインストール ガイド
VS Code（Copilot）	ワンクリックインストールまたはcode --add-mcp '{"name":"papertrade","type":"http","url":"https://papertrade-ai.ninabrekkerese.workers.dev/mcp"}'を実行します。ガイド
Gemini CLI	gemini extensions install https://github.com/nirholas/papertrade-aiを実行します。ガイド
Claude Desktop（ローカル）	リリースからpapertrade-ai.mcpbをダウンロードして開きます。
Windsurf、Zed、Cline、Goose、LibreChat、その他	上記のストリーミング可能なHTTP URL、またはstdio npx -y papertrade-aiを使用します。ガイド

ローカル（stdio）

{
  "mcpServers": {
    "papertrade": { "command": "npx", "args": ["-y", "papertrade-ai"] }
  }
}

npx -y papertrade-ai loginを一度実行し、ブラウザーでウォレットに接続します。認証情報は~/.config/papertrade-aiに保存されます（モード0600）。CLIガイド

ツール

ツール	アクセス	機能
get_markets	public	ライブの Papertrade 無期限先物市場（BTC、ETH）：Hyperliquid のマーク価格／買値／売値、24 時間変動率、Papertrade の 24 時間取引高、上限に対する未決済建玉、最大レバレッジ、最小取引サイズ、各市場の取引可否。
get_price_chart	public	Hyperliquid（Papertrade の決済に使用される価格ソース）から取得した BTC または ETH の OHLCV ローソク足、レンジ統計、TradingView リンク。
get_protocol_stats	public	Papertrade プロトコルの分析データ：TVL、証拠金、LP、累計取引高、未決済ポジション、手数料、PAPER の供給量とステーキングに加え、日次履歴（取引高、トレーダーの損益、清算、ユーザー数）。
get_liquidation_map	public	Papertrade の未決済ポジションが清算される価格：現在価格付近の価格帯ごとのロングとショートの想定元本およびポジション数、最大の集中価格帯。
get_leaderboard	public	期間を指定でき、損益、取引高、残高などで並べ替え可能な Papertrade トレーダーランキング。
get_top_trades	public	指定期間で最も利益を上げた個々の Papertrade ポジション：トレーダー、市場、売買方向、レバレッジ、エントリー、決済、損益。
get_recent_trades	public	Papertrade 全体の最新の新規建て、決済、清算。市場またはウォレットで絞り込むこともできます。
get_account	public	Papertrade アカウント情報：利用可能残高、ロックされた証拠金、エクイティ、ライブ推定損益・破綻価格・清算までの距離を含むすべての未決済ポジション、保留中のインテント、セッションキー、累計統計。
get_trade_history	public	ウォレットの決済済みおよび清算済みポジションを新しい順に表示。エントリー、決済、確定損益、手数料、ミントされた PAPER を含みます。
get_portfolio_history	public	ウォレットの 1 時間、1 日、1 週間、または全期間のエクイティ曲線。
calculate_position	public	仮想ポジションの純粋な計算：取引所の計算式（勝利曲線、デッドバンド、2％の勝利手数料）を用いた破綻価格、清算までの距離、目標決済価格での確定損益。
get_deposit_info	public	Papertrade アカウントへの入金方法：ウォレット専用の入金プロキシアドレス（HyperCore スポット上の USDC）、最低入金額、アクティベーション手数料、ウォレットの現在の HyperEVM USDC／HYPE 残高。
get_trading_permissions	public	この接続で可能な操作：接続済みウォレット、取引セッションの有効状態と有効期限、オーナーが設定したガードレール、使用済みの日次上限。
preview_trade	trading	ポジションを開くためのステップ 1／2。
open_position	trading	ステップ 2／2：委任されたセッションキーで署名し、ユーザーの資金を使って実際の Papertrade ポジションを開きます。
close_positions	trading	セッションキーで署名し、未決済ポジションを成行で決済します。
cancel_intent	trading	送信済みで、まだキューに残っている（未実行の）インテントをキャンセルします。
get_intent_status	public	送信済みインテントがまだキューに残っているか、未決済ポジションが作成されたか、または保留状態ではなくなったかを確認します。

すべての入力と注釈：ツールリファレンス。公開ツールは通常の HTTPS 経由でも利用できます：

curl https://papertrade-ai.ninabrekkerese.workers.dev/api/v1/tools/get_markets
curl "https://papertrade-ai.ninabrekkerese.workers.dev/api/v1/tools/get_liquidation_map?market=ETH"

GPT Actions とエージェントフレームワークに対応した OpenAPI 3.1 は /openapi.json にあります。読み取り専用エージェント向けの認証不要 MCP：https://papertrade-ai.ninabrekkerese.workers.dev/public/mcp。

セキュリティ

• ノンカストディアルです。 ウォレットは、公式の Papertrade アプリがワンクリック取引で署名するものと同じ EIP-712 RegisterSessionKey メッセージに署名します。セッションキーの権限は、取引所コントラクトによってポジションの新規作成、決済、キャンセルに限定されます。出金や送金はできません。
• ガードレールはプロンプトではなく、コードで適用します。 取引ごとの証拠金、レバレッジ、直近24時間のポジションサイズ、保有中のポジション、市場は、インテントへの署名前にサーバーで検証されます。
• プレビューしてから確定します。 open_position には、同一の取引を対象とした preview_trade の署名済み見積もりが必要です。有効期間は3分です。
• アプリごとに暗号化されます。 各アプリのセッションキーは、そのアプリ固有のアクセストークンから導出されたキーで暗号化されます。
• ワンクリックで取り消せます：／account。

詳しくはセキュリティモデルをご覧ください。脆弱性は非公開でご報告ください：SECURITY.md。

開発とセルフホスト

git clone https://github.com/nirholas/papertrade-ai && cd papertrade-ai
npm install
npm test           # unit tests
npm run dev        # local Worker on http://127.0.0.1:8787

KV 名前空間1つとシークレット1つで、独自のコピーを Cloudflare Workers にデプロイできます：セルフホスト。このパッケージは、独自のエージェントで使えるツールレジストリ、ポリシーエンジン、インテント署名もエクスポートします：import { TOOLS, runTool } from 'papertrade-ai'。

パス	内容
src/tools/registry.ts	すべてのツール：スキーマ、アノテーション、実装
src/core/	Papertrade API クライアント、EIP-712 インテント、清算価格の計算
src/worker/	Cloudflare Worker：OAuth プロバイダー、MCP、REST、ページ
src/cli.ts	stdio サーバーと login CLI
src/web/	MCP Apps ウィジェット、接続ページ、アカウントページ
docs/	ドキュメント（ウェブサイトに表示）
scripts/build-site.mjs	ウェブサイト、llms.txt、サイトマップ、ディスカバリーファイル、マニフェスト

リスク

Papertrade のポジションでは、実際の USDC を使用します。レバレッジ1000倍では、価格が不利な方向に0.1%動くだけでポジションが清算され、証拠金全額を失います。Papertrade AI は独立したオープンソースソフトウェアであり、Papertrade とは無関係です。また、金融アドバイスではありません。

ライセンス

MIT

プロジェクトを支援する

papertrade-ai が時間の節約に役立ったら、GitHub でスターを付けてください。スターがあると、ほかの開発者や AI エージェントが信頼できるリポジトリを見つけやすくなります。クリックは1回で済みます。

使いそうな人を知っていますか？X に投稿 · Bluesky で共有 · LinkedIn で共有 · Hacker News に投稿 · Reddit で共有

AI エージェントにも対応

コーディングエージェントや LLM ツールは、このリポジトリを直接読み取れます：AGENTS.md、llms.txt、llms-full.txt。エージェントに https://github.com/nirholas/papertrade-ai を指定すれば、必要なコンテキストを取得できます。

同じ作者のその他のプロジェクト

• nirholas のすべてのリポジトリ：トピック別にまとめた全カタログ
• three.ws：Solana ウォレット、スキルマーケットプレイス、x402 決済を備えた 3D AI エージェント向けプラットフォーム
• 質問やアイデア：issue を作成するか、ディスカッションを開始してください

コントリビューター

スター履歴