tradeledger

tradeledger

查看实时交易实验的只读窗口。tradeledger 可让 Agent 报告实验的实际状态——当前余额和未平仓头寸、实际平仓的交易、它运行的贡献者影子规则，以及它讲述的自身故事——而不是编造看似合理的数字。

这里的任何内容都不会执行交易。五个工具只读取公开数据；接口中没有下单、钱包或账户写入操作，也不需要或接受任何凭据。

工具

工具	参数	可查询内容
get_live_status	—	余额、总 PnL、胜率、交易次数、市场状态，以及运行中时的未平仓头寸。
get_recent_trades	limit（可选整数）	最近平仓的交易，每笔都包含方向、退出原因、PnL 和市场状态。
list_adopted_rules	status（可选：adopted、queued 或 all）	贡献者提出的影子规则，按其当前状态筛选。
get_rule_status	rule_id（必需字符串）	单条规则在各分组中的命中率，以及距离晋升门槛还有多远。
get_latest_saga_chapter	lang（可选：en 或 zh）	实验叙事传奇中的最新篇章。

工作原理

tradeledger 是一个转发客户端。工具调用会打包成 JSON-RPC tools/call 请求，并发送到单个上游 MCP 端点；上游返回的内容会原样交还。 上游发生故障时，返回的答案是以 tradeledger error: 开头的错误文本——绝不会在本地编造数据。

来源说明

端点和转发形式均标注为重建版本。原始服务的公开说明以文字形式列出了数据来源，但未公布各工具对应的端点，因此 此重建版本会将每次调用都指向一个可配置的上游：

• IBITLABS_MCP_URL — 上游 MCP 端点。默认值： https://www.ibitlabs.com/api/mcp（标注为重建版本）。
• REQUEST_TIMEOUT_MS — 每次请求的超时时间。默认值：15000。

将其作为 MCP 服务运行

{
  "mcpServers": {
    "tradeledger": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tradeledger", "mcp"]
    }
  }
}

也可以在容器中运行：

docker run -i ghcr.io/cloudcorprecords/tradeledger

将其作为 CLI 运行

npx @reneturcios/tradeledger get_live_status '{}'
npx @reneturcios/tradeledger get_recent_trades '{"limit": 2}'
npx @reneturcios/tradeledger get_rule_status '{"rule_id": "F"}'
npx @reneturcios/tradeledger --version

每个工具子命令只接受一个包含工具参数的 JSON 对象字符串，并打印结果文本。成功时退出码为 0，结果为错误时为 1，用法错误时为 2。

开发

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts — offline; the upstream is stubbed
npm run dev     # tsx src/cli.ts — run the CLI from source

测试套件不会访问网络：它使用模拟的 JSON-RPC 上游来运行核心逻辑，其载荷采用公开的示例响应，并检查这些响应是否原样透传、故障是否会转换为 tradeledger error: 结果，以及提供的工具列表是否与约定的五个工具完全一致。

许可证

MIT。参见 LICENSE。