tradeledger

tradeledger

稼働中のトレーディング実験を読み取り専用で参照する窓口です。tradeledger を使うと、もっともらしい数値を作り出すのではなく、実験の実際の状態、つまり現在の 残高とオープンポジション、実際に決済した取引、適用しているコントリビューターの シャドールール、そして実験自身が語るストーリーをエージェントが引用できます。

ここでは取引は行われません。5 つのツールは公開データを読み取るだけです。 インターフェースには注文、ウォレット、アカウントへの書き込み操作はなく、 認証情報も不要で、受け付けません。

ツール

ツール	引数	取得できる情報
get_live_status	—	残高、合計損益、勝率、取引数、市場レジーム、稼働中の場合はオープンポジション。
get_recent_trades	limit（省略可能な整数）	直近の決済済み取引。それぞれの方向、決済理由、損益、レジームを取得します。
list_adopted_rules	status（省略可能：adopted、queued、または all）	コントリビューターが提案したシャドールールを、現在の状態で絞り込んで取得します。
get_rule_status	rule_id（必須の文字列）	1 つのルールについて、バケットごとのヒット率と昇格基準までの距離を取得します。
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 オブジェクト文字列を ちょうど 1 つ渡します。結果のテキストが出力されます。終了コードは、 成功時が 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: の結果になること、 そして提供されるツール一覧が契約で定められた 5 つのツールと正確に一致することを 確認します。

ライセンス

MIT。詳細は LICENSE を参照してください。