Papertrade AI

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

一个 URL，OAuth 2.1，无需 API 密钥。你的钱包只需签名一次，即可注册一个可以交易但不能提现的会话密钥；服务会强制执行你设置的限制：每笔交易的保证金、杠杆、每日交易规模、未平仓头寸和市场。每笔交易都会先预览，并需要你确认。

你可以询问

• “Papertrade 上的 BTC 和 ETH 现在走势如何？”
• “给我看看 Papertrade 上 ETH 的清算图。”
• “本周 Papertrade 排名前 10 的交易者是谁？他们持有哪些资产？”
• “分析钱包 0x...：胜率、最大单笔交易、权益曲线。”
• “如果我用 $20 以 500x 做多 BTC，清算价格是多少？”
• “预览一笔 800x、$15 的 ETH 空单；如果我确认，再开仓。”
• “平掉我所有的 BTC 仓位。”

在支持 MCP Apps 的客户端（Claude、ChatGPT、VS Code、Goose）上，结果会以交互式交易卡片呈现，并附带实时图表。

安装

客户端	安装
Claude（网页、桌面、移动端）	依次点击 Settings、Connectors、Add custom connector，粘贴 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	依次点击 Settings、Apps、Advanced settings、Developer mode、Create app，粘贴 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（本地）	从 Releases 下载 papertrade-ai.mcpb 并打开。
Windsurf、Zed、Cline、Goose、LibreChat 等	使用上方的 Streamable 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	公开	Papertrade 永续合约市场（BTC、ETH）的实时数据：Hyperliquid 标记价／买价／卖价、24 小时涨跌幅、Papertrade 24 小时交易量、未平仓合约量与上限、最大杠杆、最小交易规模，以及各市场是否开放。
get_price_chart	公开	来自 Hyperliquid 的 BTC 或 ETH OHLCV 蜡烛图（Papertrade 结算所依据的价格来源），包含区间统计数据和 TradingView 链接。
get_protocol_stats	公开	Papertrade 协议分析数据：TVL、保证金、LP、累计交易量、未平仓头寸、费用、PAPER 供应量和质押数据，以及每日历史数据（交易量、交易者盈亏、清算、用户）。
get_liquidation_map	公开	Papertrade 未平仓头寸的清算分布：按当前价格附近的价格区间统计多头和空头的名义价值及头寸数量，并显示最大的聚集区。
get_leaderboard	公开	Papertrade 交易者排行榜，可按时间范围筛选，并按盈亏、交易量、余额等排序。
get_top_trades	公开	指定时间范围内盈利最高的 Papertrade 单笔头寸：交易者、市场、方向、杠杆、入场价、退出价和盈亏。
get_recent_trades	公开	Papertrade 中最新的开仓、平仓和清算记录，可按市场或钱包筛选。
get_account	公开	Papertrade 账户信息：可用余额、已锁定保证金、净值、所有未平仓头寸及其实时预估盈亏、爆仓价格和距清算价格的距离、待处理意图、会话密钥和累计统计数据。
get_trade_history	公开	钱包的已平仓和已清算头寸，按时间从新到旧排列，包含入场价、退出价、结算盈亏、费用和铸造的 PAPER。
get_portfolio_history	公开	钱包在 1 小时、1 天、1 周或全部时间范围内的净值曲线。
calculate_position	公开	针对假设头寸进行纯数学计算：爆仓价格、距清算价格的距离，以及按交易所公式（盈利曲线、无效区间、2% 盈利费用）计算的目标退出价结算盈亏。
get_deposit_info	公开	如何为 Papertrade 账户充值：钱包专属的存款代理地址（HyperCore 现货 USDC）、最低金额、激活费用，以及钱包当前的 HyperEVM USDC/HYPE 余额。
get_trading_permissions	公开	此连接可执行的操作：已连接的钱包、交易会话是否有效及其到期时间、所有者设置的限制，以及每日限额的使用情况。
preview_trade	交易	开仓的第 1 步，共 2 步。
open_position	交易	第 2 步，共 2 步：使用用户资金开立真实的 Papertrade 头寸，并由委托的会话密钥签名。
close_positions	交易	在市场价平仓，并由会话密钥签名。
cancel_intent	交易	取消仍在队列中（尚未执行）的已提交意图。
get_intent_status	公开	查询已提交的意图是否仍在队列中、是否已生成未平仓头寸，或是否已不再待处理。

完整输入和注释请参阅：工具参考。公开工具也可通过普通 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"

OpenAPI 3.1 文档位于 /openapi.json，可供 GPT Actions 和 Agent 框架使用。供只读 Agent 使用的免认证 MCP：https://papertrade-ai.ninabrekkerese.workers.dev/public/mcp。

安全性

• 非托管。 你的钱包会签署一条 EIP-712 RegisterSessionKey 消息，与官方 Papertrade 应用进行一键交易时签署的消息相同。交易所合约将会话密钥限定为开仓、平仓和取消操作。它无法提现或转账。
• 在代码中设置护栏，而非依赖提示词。 在签署任何意图之前，服务端会检查每笔交易的保证金、杠杆、滚动 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 命名空间和一个密钥，将自己的副本部署到 Cloudflare Workers：自托管。此软件包还导出了工具注册表、策略引擎和意图签名功能，供你在自己的 Agent 中使用：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 命令行工具
src/web/	MCP Apps 小组件、连接和账户页面
docs/	文档（呈现在网站上）
scripts/build-site.mjs	网站、llms.txt、站点地图、发现文件、清单

风险

Papertrade 持仓使用真实 USDC。使用 1000 倍杠杆时，若价格朝不利方向变动 0.1%，持仓就会被清算，全部保证金也将损失。Papertrade AI 是独立的开源软件，与 Papertrade 无关联，也不构成财务建议。

许可证

MIT

支持项目

如果 papertrade-ai 为你节省了时间，欢迎**在 GitHub 上为它点星**。星标能帮助其他开发者和 AI Agent 找到值得信赖的代码仓库，而你只需点击一下。

认识可能会用到它的人吗？发布到 X · 分享到 Bluesky · 分享到 LinkedIn · 提交到 Hacker News · 分享到 Reddit

也为 AI Agent 而构建

编码 Agent 和大模型工具可以直接读取此代码仓库：AGENTS.md、llms.txt、llms-full.txt。将 https://github.com/nirholas/papertrade-ai 提供给 Agent，它就能获取所需的上下文。

同一作者的更多项目

• nirholas 的所有代码仓库：按主题分类的完整目录
• three.ws：一个 3D AI Agent 平台，提供 Solana 钱包、技能市场和 x402 支付
• 有问题或想法？提交 issue 或发起讨论

贡献者

Star 历史