Coinrithm Agent Trading

@coinrithm/mcp-trading

ペーパーマネーを使って、AI エージェントを無料で稼働させましょう。 どのモデル（Claude、GPT、Gemini、Llama…）にも 50,000 mUSD の仮想口座を与え、CoinRithm で現物、先物、予測市場を取引させることができます。実際のお金や取引所は不要です。バージョン管理され、確信度で重み付けされた実現損益の算出方式を採用した、公開の エージェントアリーナ リーダーボードも利用できます。ペーパートレードの結果は、将来の収益や実際の取引執行のパフォーマンスを示すものではありません。

さらに、予測市場データを無料で提供します。キーは一切不要です。 同じサーバーには、CoinRithm の公開クロスベニューデータセットを提供する、キー不要の pm_data_* ツールが 17 個含まれています。オッズ、サイズ加重の参照確率を用いたベニュー間の一致情報、クジラの取引履歴、マーケット全体の出来高統計、アウトカムの価格履歴とオーダーブック、決着済み・期限切れ間近・サプライズのマーケットを利用できます。利用可能性とデータの鮮度はソースによって異なります。返されるソースの健全性と観測メタデータを確認してください。カタログは 12 のベニュー（Polymarket、Kalshi、Smarkets、Limitless、Manifold、Metaculus、PredictIt、Rothera、Futuur、Myriad、ForecastEx、Gemini）を網羅しています。Streamable HTTP に対応する MCP クライアントからホスト済みエンドポイント https://mcp.coinrithm.com/mcp に接続すれば、匿名でツールを呼び出せます。API キーが必要なのは、アカウントおよび取引ツールです。instrument_markets（コイン、TradFi ティッカー、または指数のストライク価格一覧）、tradfi_references、crypto_price、get_crypto_movers、get_arena_leaderboard、get_arena_agent も匿名で利用でき、キー不要のツールは合計 23 個 です。

エージェントは OKF バンドル です。Markdown と YAML（戦略、ペルソナ、厳格な上限値）で構成される、オープンでモデルに依存しないフォルダーで、どのランタイムからでも読み込めます。同じバンドルを実行する方法は 2 つあります。

• マネージド — インストール不要。 Agent Studio（CoinRithm → My Agents → Studio）をブラウザーで使ってエージェントを作成・デプロイできます。ハウスエージェントをフォークするか、一から作成すれば、CoinRithm が常時稼働のスケジューラーで実行します。Studio には設定済みのモデルが表示されますが、共有プールによるルーティングでは別の適格モデルが使われる場合があります。各エージェントの設定と実行証跡を確認してください。
• セルフホスト — このパッケージを使用。 自分のモデルキーを用意し、マシン上で observe→decide→validate→act のループを実行するか、MCP サーバーを Claude Desktop / Cursor / Codex に接続します。

このパッケージには 2 つのバイナリが含まれています。

• coinrithm-mcp — 個人用 API キーを使って、AI エージェントが CoinRithm でペーパートレード（現物、先物、予測市場）を行えるようにする MCP サーバーです。
• coinrithm-agent — セルフホスト型のエージェントランナーです。エージェントをフォルダーとして作成し、自分のモデルキーを使って observe→decide→validate→act のループを実行できます。デフォルトではドライランです。詳しくは以下の［エージェントランナー](#agent-runner-coinrithm-agent)をご覧ください。

ペーパートレード専用 — 仮想資金（50,000 mUSD）を使用します。金融上の助言ではありません。

Version 0.7.19

データ専用モードでは COINRITHM_API_KEY がなくてもローカルサーバーが起動するため、 npx -y @coinrithm/mcp-trading を実行すれば、アカウントなしで予測市場と暗号資産のデータを取得できます。キーが必要なツールは、キーが設定されるまで構造化された missing_api_key の結果を返します。上流への呼び出しは35秒後にタイムアウトします（upstream_timeout）。 ホスト型サーバーにはクライアントごとの制限（1分あたり120リクエスト、同時実行数64）があり、デプロイ時に処理中のリクエストが完了するまで待機し、/health でバージョンを報告します。デフォルトのツール数は41のままです。CHANGELOG.mdを参照してください。

Version 0.7.17では、デフォルトのツール数を41のまま維持しました。サーバー全体で有効化できる2つのオプトインフラグにより、設定済みのハウスキー用のPM paper v2ツールとスポット価格参照ツールを追加できます。どちらも有効化しない限り無効です。

ランナーにはオプトインの capitalSizing.highConviction ティアを追加しました。また、正しい側の利確目標がエージェント自身の報酬対リスクの下限を下回る場合、目標を引き上げます（資本サイジングを行うエージェントのみ）。要求された目標と適用された目標も記録します。次のプロンプトには、前回の判断で拒否されたアクション、各オープンポジションのマーク価格に対するストップロスの位置、監視対象のコインのうち新たな先物取引を開始できるものが含まれます。保留中の先物決済は、実行済みや失敗ではなく、保留中として記録されます。CHANGELOG.mdを参照してください。

Version 0.7.16（公開日：2026-10-07）では、有効に見える先頭部分を含め、プロバイダーの応答が明示的に不完全な場合、実行前に拒否するようになりました。また、その場合もトークン使用量を保持します。さらに、設定可能なユニバースとシグナルの境界、PMポリシー、目標に関するガイダンス、個別に計時される市場コンテキスト、および record／bench／label 評価ツールを追加しました。取引所ごとの資金調達率のコンテキストは決済に影響しません。オプションデータには、ソース、カバレッジ、タイミングの制限が保持されます。ベンチマークでは、結果が欠落している場合や、上限付きのルート診断情報も保持されます。これらは、収益性の高い戦略や優れたモデルを証明するものではありません。ランナーのドキュメントを参照してください。

Version 0.7.15では、公開市場サマリーに観測価格の根拠（hasObservedPrice と上限付きの sourceObservation。取引所の比較では両側の情報を含みます）を保持し、クジラのサマリーでは pm_data_whale_wallet による追跡用に完全な公開 walletAddress 値を保持します。また、オプトインの whale_context ランナー機能を追加し、推論前にスキップされたサイクルについて、モデルとアクションの根拠が明示的にゼロであることを記録します。pm_data_canonical では、新しい正規の consensus と、ラベル付きの consensusHistory について説明しています。ホスト型HTTPサーバーでは、貼り付けられたMarkdown内のディスクリプターリンクを復元します（GET／HEADはディスクリプターにリダイレクトし、POSTはMCPを実行します）。取引制限、リスクゲート、再試行回数に変更はありません。CHANGELOG.mdを参照してください。 レジストリでの提供状況については、npm view @coinrithm/mcp-trading version とリリース状況を確認してください。ホスト型デプロイとnpmリリースは別々です。

ランナーAPIの操作には、応答本文の取得や429エラー時の再試行待ち時間を含め、合計30秒の期限が適用されます。タイムアウトとキャンセルの結果は未確認のままです。クライアントが、結果の不確かな取引書き込みを自動的に再実行することはありません。

ランナーを組み込みますか？サポート対象のエンジンと状態ヘルパーを使うには、@coinrithm/mcp-trading/engine からインポートしてください。既存の dist/agent/engine.js からのインポートも引き続き利用できます。正確なオプトインポリシーと永続化の契約については、エントリー条件とエンジンのガイドを参照してください。

クイックスタート

# Prediction-market and crypto data only, no account or key needed:
npx -y @coinrithm/mcp-trading

# Add your CoinRithm key to enable paper trading (no install needed):
COINRITHM_API_KEY=crk_live_… npx -y @coinrithm/mcp-trading

CoinRithm → Settings → API Keys から crk_live_… キーを取得してください。セルフホスト型エージェントを作成して実行する場合は、エージェントランナーを参照してください。ソースからビルドする場合は、Node 20.19+ または 22.12+ を使用し、npm ci && npm run build を実行してください。 強制適用されるステートメント、ブランチ、関数、行の各カバレッジ基準（90%）を確認するには、npm run test:coverage を実行してください。カバレッジの対象範囲と信頼性チェックを参照してください。

エージェントランナー（coinrithm-agent）

このパッケージには、セルフホスト型エージェントランナーも含まれています。エージェントはフォルダーとして作成します（戦略とハード上限を Markdown/YAML で記述）。ランナーはそれをコンパイルし、observe → decide → validate → act のループを実行します。_ご自身の_モデル（独自のキーを使用）に構造化された判断を求め、設定した上限を通過した判断のみを実行します。デフォルトはドライランで、現物、先物、予測市場のすべてでペーパー取引のみを行います。

coinrithm-agent new my-agent --preset conservative
coinrithm-agent validate my-agent
COINRITHM_API_KEY=crk_live_… ANTHROPIC_API_KEY=sk-ant-… \
  coinrithm-agent run my-agent --once --dry-run

環境変数、フェイルクローズの保証、フォルダーレイアウトを含む詳細なガイドは、**docs/agent-runner.md**を参照してください。 ホスト型スケジューラーは、pm が対象範囲に含まれている場合、オプトイン方式の whale_context 機能をサポートします。イベント駆動のゲートが作動すると、ランナーは上限付きの公開取引テープサンプルと、検証済みのウォレット移動概要を最大2件、非メカニカルプロバイダー向けのモデル観測に追加します。この読み取りはベストエフォートで、利用状況を明示します。PM の候補を増やしたり、リスクゲートや書き込みゲートを回避したりすることはありません。オーナーは Agent Studio の「Risk & caps」でこの機能を有効にできます。既存のエージェントは、オーナーが選択しない限りオプトアウトのままです。この機能はパッケージバージョン 0.7.15 に含まれます。それ以前の MCP 0.7.14 には含まれていません。 CoinRithm のホスト型スケジューラーは、同じエンジンを実行します。ビルド済みの DB 駆動ランタイムについては、スケジューラーの READMEを参照してください。

実行方法は2通り

モード	エントリーポイント	認証	対象ユーザー
stdio（シングルユーザー、ローカル）	dist/index.js	COINRITHM_API_KEY 環境変数	ご利用のマシン上の Claude Desktop / Cursor / Codex
Streamable HTTP（マルチユーザー、ホスト型）	dist/http.js	リクエストごとの Authorization: Bearer ヘッダー	mcp.coinrithm.com の共有ホスト型エンドポイント

ホスト型 HTTP サーバーはキーを保持しません。各リクエストで crk_live_… を Authorization ヘッダーに指定し、サーバーはそのキーをそのまま上流に転送します。ホスト型エンドポイントでは Authorization ヘッダーは省略可能です。17個の pm_data_* ツール、instrument_markets、tradfi_references、crypto_price、get_crypto_movers、get_arena_leaderboard、get_arena_agent は匿名で利用できます。アカウントおよび取引ツールの利用には認証が必要です。 DEPLOY.mdを参照してください。

独自のモデルキーを使用する

ホスト型 Agent Studio では、NVIDIA がホストするモデルの共有プール上でエージェントを無料で実行できます。このプールはすべてのホスト型エージェントで共有する固定予算のため、スケジューラーは共有エージェントの実行頻度に下限を設けており、参加するエージェントが増えるほど間隔が長くなります。独自のモデルキーを使用すると、共有プールによる実行間隔の下限がなくなります。ただし、プロバイダーのクォータ、実行時間、トリガーポリシー、アカウント保護は引き続き適用されます。

	無料共有プール	独自のキー
モデル	無料のホスト型モデル	プロバイダーが提供する任意のモデル
間隔	プール内のエージェント数に応じて下限が設定されます	完了後に設定した間隔（他の制限に従います）
経路変更	モデルがレート制限された場合、利用可能な別のモデルに切り替わることがあります	経路は切り替わらず、指定した経路が固定されます
コスト	無料	CoinRithm ではなく、プロバイダーに支払います

利用可能なプロバイダー：nvidia、openai、groq、anthropic、および任意の openai-compatible エンドポイント（https のベース URL が必要です）。キーは エージェントの受け入れ前に実際の判定プローブで検証されます。判定結果を解析可能な形式で返せないモデルは、スケジュールされた実行のたびに失敗するのではなく、デプロイ時に拒否されます。キーは保存時に暗号化され、ログに記録されたり、そのまま出力されたりすることはありません。

このパッケージを使ったセルフホストも同様に動作します。プロバイダーの環境変数（OPENAI_API_KEY、ANTHROPIC_API_KEY、NVIDIA_API_KEY、GROQ_API_KEY、GEMINI_API_KEY、またはMODEL_API_KEY）を設定すると、ランナーはそのプロバイダーのモデルファミリーが実際に受け付ける形式でリクエストを構築します。モデルキーがエージェントファイルから読み取られることはありません。

設定（stdio）

Env var	必須	デフォルト	説明
COINRITHM_API_KEY	いいえ（stdio のみ）	—	CoinRithm → Settings → API Keys で取得したcrk_live_…キーです。設定しない場合、データツールのみを利用できます。HTTP エントリでは無視されます。
COINRITHM_API_URL	いいえ	https://api.coinrithm.com	上流のベース URL（本番環境）
PORT	いいえ	8787	HTTP エントリのみ
COINRITHM_PM_PAPER_V2_TOOLS_ENABLED	いいえ	off	trueにすると、設定済みのハウスキーでPM paper v2 ツールを追加します。
COINRITHM_SPOT_REFERENCE_TOOLS_ENABLED	いいえ	off	trueにすると、get_spot_referenceを追加します。

実行

• stdio（Claude Desktop / Claude Code / Cursor / ほとんどの MCP ホスト向け）：

  COINRITHM_API_KEY=crk_live_... node dist/index.js
  # or, after npm link / npx:
  coinrithm-mcp
  

• Streamable HTTP（マルチユーザー向け。環境変数にキーを設定せず、クライアントがそれぞれ独自のキーを送信します）：

  npm run start:http
  # POST http://localhost:8787/mcp  with  Authorization: Bearer crk_live_...
  # GET  http://localhost:8787/healthz  (liveness, no auth)
  

ツール

ツール	スコープ	ラップする内容
whoami	任意	GET /api/agent/me
get_portfolio	読み取り	GET /api/agent/portfolio
get_wallet	読み取り	GET /api/agent/wallet
resolve_symbol	読み取り	GET /api/agent/resolve
get_equity_curve	読み取り	GET /api/agent/equity-curve
get_my_trades (venue)	読み取り	GET /api/agent/trades
get_market_context (coinId)	読み取り	GET /api/agent/market/:coinId
get_news (coins, limit?, hours?, minImportance?)	読み取り	GET /api/agent/news
get_candles (coinId, range)	読み取り	GET /api/agent/market/:coinId/candles
discover_pm_markets	読み取り	GET /api/agent/pm/discover
get_performance	読み取り	GET /api/agent/performance
get_agent_ledger	読み取り	GET /api/agent/ledger
export_agent_ledger	読み取り	GET /api/agent/ledger/export
export_run_evidence	読み取り	GET /api/agent/ledger/export?runId=...
get_arena_leaderboard	なし（公開）	GET /api/arena
get_arena_agent (handle)	なし（公開）	GET /api/arena/:handle
list_open_orders	読み取り	GET /api/agent/orders/open
get_positions (venue)	読み取り	GET /api/agent/positions/{futures,pm}
spot_quote	読み取り	POST /api/agent/spot/quote
futures_quote	読み取り	POST /api/agent/futures/quote
pm_quote	読み取り	POST /api/agent/pm/quote
place_spot_order	trade:spot	POST /api/agent/spot/order
cancel_spot_order	trade:spot	POST /api/agent/spot/order/:id/cancel
open_futures_position	trade:futures	POST /api/agent/futures/open ¹
set_futures_sl_tp	trade:futures	POST /api/agent/futures/sl-tp ²
close_futures_position	trade:futures	POST /api/agent/futures/close
open_pm_position	trade:pm	POST /api/agent/pm/open ¹
report_pm_opportunity	読み取り	POST /api/agent/pm/opportunity
pm_data_overview	なし（公開）	コンパクトな GET /api/prediction-markets/overview
pm_data_sources	なし（公開）	取引所ごとの方法論、対象範囲、比較可能な出来高の基準
pm_data_sources_health	なし（公開）	取引所ごとのデータ鮮度、遅延、劣化の理由
pm_data_events	なし（公開）	コンパクトな GET /api/prediction-markets/events
pm_data_event (source, slug, detail?)	なし（公開）	デフォルトでは範囲を限定したイベントの根拠を返します。detail: "full" の場合は変更されていない API レコードを返します
pm_data_whales (limit, default 10)	なし（公開）	コンパクトな GET /api/prediction-markets/whales
pm_data_whale_wallets (limit, window)	なし（公開）	コンパクトな GET /api/prediction-markets/whales/wallets
pm_data_whale_wallet (source, wallet)	なし（公開）	移動の詳細 GET /api/prediction-markets/whales/wallets/:source/:wallet
pm_data_disagreements (limit, sort, sourceKind, ...)	なし（公開）	コンパクトな GET /api/prediction-markets/matches/public
pm_data_calibration	なし（公開）	GET /api/prediction-markets/calibration
pm_data_canonical (key?, limit, cursor)	なし（公開）	GET /api/prediction-markets/canonical（および /:key の詳細）
pm_data_volume_history	なし（公開）	GET /api/prediction-markets/volume-history
pm_data_price_history (source, slug, interval?)	なし（公開）	GET /api/prediction-markets/event/:source/:slug/price-history、サンプリング済み
pm_data_orderbook (source, slug, depth?)	なし（公開）	GET /api/prediction-markets/event/:source/:slug/orderbook、最良気配値
pm_data_resolved (limit, source, year, month, ...)	なし（公開）	コンパクトな GET /api/prediction-markets/resolved
pm_data_expiring (limit, days, source)	なし（公開）	コンパクトな GET /api/prediction-markets/expiring
pm_data_surprises (limit, window, source)	なし（公開）	コンパクトな GET /api/prediction-markets/surprises
get_crypto_movers (direction, limit)	なし（公開）	GET /api/coins/top-{gainers,losers}
instrument_markets (type, id, horizon?, detail?)	なし（公開）	コンパクトな GET /api/instruments/:type/:id/markets（権利行使価格の一覧）
tradfi_references (ticker?, assetClass?, window?)	なし（公開）	GET /api/market/references（および /:ticker の詳細）
crypto_price (slug, fiat?, candles?, maxPoints?)	なし（公開）	コンパクトな GET /api/coins/:slug（および /:slug/candles、統合済みバー）
パッケージバージョン 0.7.15 以降（npm の 0.7.14 ではありません）では、pm_data_whales とデフォルトの
pm_data_event の概要に、API が公開する完全な walletAddress が保持されます。
その値を source とともに pm_data_whale_wallet に渡すと、Polymarket、Limitless
または Myriad の情報を取得できます。短い wallet フィールドは表示用テキストです。walletAddress が null または存在しない場合、Kalshi の匿名取引を含め、有効なウォレット ID は得られません。
ウォレットのリーダーボード行では、同じツール入力に address を使用します。

get_crypto_movers はユニバーススキャンです。CoinRithm が追跡するすべてのコインの中から、過去 24 時間で最も大きく値動きしたものを取得するため、エージェントは監視対象に設定されていないコインも候補として見つけられます。各行の coinId は get_candles と get_market_context が受け取る値です。シンボルは上場先によって重複し、検索すると値動きしたコインとは別のコインにたどり着く場合があるため、シンボルを解決せず、そのまま渡してください。セルフホストのランナーは、universe_scan 機能を持つエージェントに対してこれを自動的に実行します。

17 個の pm_data_* ツールは、CoinRithm の無料公開クロスベニュー・データセット（全 12 のベニュー：Polymarket、Kalshi、Smarkets、Limitless、Manifold、 Metaculus、PredictIt、Rothera、Futuur、Myriad、ForecastEx、Gemini）をラップしています。API キーは不要で、ユーザーの API キーが付与されることもありません。これらはリサーチ用のデータです。pm_data_events の一覧行には referenceProbability が含まれます（マッチした質問における、ベニュー横断のサイズ加重コンセンサス。建玉、または建玉がない場合は流動性で加重）。pm_data_event には、他のベニューで同じ現実世界の質問に付けられた価格を示す crossSourceMatches、referenceProbability、volumeHistory、および解決を裏付ける証拠が含まれます。 探索の呼び出しでは、エージェントが調査対象を決める前にコンテキストを消費しないよう、詳細な説明、すべてのアウトカムの価格一覧、埋め込みイベントオブジェクト、スパークラインを意図的に省いています。イベント検索では、最大 5 件のアウトカムと outcomeCount が返されます。オープンイベントでは、結果または closed、resolved、voided のライフサイクル状態がないアウトカムが先に並びます。それ以外のイベントステータスでは、プロバイダーが確認した勝者が先に並びます。各グループ内では、有効な確率があるアウトカムを高い順に並べ、同率の場合は元の順序を維持します。続けて pm_data_event(source, slug) を呼び出して範囲を限定したイベント証拠を取得し、プロバイダー由来の完全なレコードが必要な場合に限り、detail: "full" をリクエストしてください。 範囲を限定したアウトカムの概要には、hasObservedPrice と sourceObservation が含まれることがあります。hasObservedPrice:false は、プロバイダーから有効な観測価格の入力がなかったことを示します。一方、hasObservedPrice フィールドが省略されている場合は不明です。 sourceObservation:null は、出所情報を利用できないことを意味し、そのアウトカムに価格がない証拠ではありません。どちらのフィールドも、リアルタイムの価格、流動性、または取引可能性を示すものではありません。 priceBasis（Polymarket と Kalshi のオープンアウトカム）は、確率の根拠を示します。book_mid、last_trade、または unquoted のいずれかです。unquoted は、取引実績がなく有効な板情報もないことを意味するため、その数値は価格ではありません。 数値は、開示されたベニューごとの基準に基づき自社で計算した集計値です。引用する際は CoinRithm を明記してください。 CoinRithm のトラストレイヤー機能もキー不要です。pm_data_disagreements は、同一の現実世界の質問に対する、グラフクラスタリングされ、方向性が確認された取引所間の確率差を返します（各クラスターは、ペアごとの比較で差分が大きい上位 5 件の共通結果までに制限されます）。pm_data_calibration は市場価格の較正を測定します。主要なレーンでは、解決前 20～28 時間の範囲内で、解決時刻の 24 時間前に最も近い完全な板のスナップショットを 1 つ選択し、イベント加重の Expected Calibration Error と 10 バケットの信頼度曲線を使用します。比較可能なサンプル内では ECE が低いほど良好です。これはプロバイダーやエージェントの予測スキル、または収益性を示すものではありません。finalPrice レーンと ownCapture レーンはそれぞれ異なるタイミング基準を使用しており、主要なレーンとは比較できません。pm_data_canonical は、1 つの質問を取引所間で識別する CoinRithm の安定した ID です（一覧を取得するか、key を渡すと、1 つのカノニカルに属する取引所のメンバーと追記専用の判定履歴を取得できます）。また、pm_data_volume_history は、グローバルな日次出来高の推移を返します（実資金を扱う取引所のみ、約 90 日のローリングウィンドウ）。

pm_data_price_history と pm_data_orderbook は、1 つの結果のネイティブな履歴とライブ板を読み取ります（Polymarket と Kalshi に対応。その他の取引所では、空の系列または orderBook: null が返されます）。どちらも 0～1 の割合を使用し、イベント結果の 0～100 ポイントとは異なります。履歴は maxPoints 件に均等にサンプリングされ、元の pointCount も返されます。板は各サイドの最良の depth 段を保持し、段数の合計も返します。pm_data_resolved、pm_data_expiring、pm_data_surprises は、それぞれ解決済みアーカイブ、まもなく終了する未解決イベント、解決済みイベントのうち最大の予想外の結果をページ形式で返します。各行は同じ簡潔なイベント概要にまとめられています。

instrument_markets は「この価格について予測市場が示唆する内容」を返します。コイン（bitcoin などのスラッグで指定）、TradFi ティッカー、または指数に紐づく契約を、満期日と決済元ごとにグループ化し、取引所系列ごとに 1 つのラダーを返します。確率は取引所価格を 0～100 ポイントで表したもので、各ラダーには決済元と参照価格との関係が示されます。ペイロードにライブ価格は含まれません。デフォルトではラダーを 10 件返し、取引所の結果 ID は省略されます。detail: "full" を指定すると、未加工のレコードが返されます。tradfi_references は TradFi 参照情報のカタログを一覧表示します（デリバティブ取引所の指数価格の USDT 建て中央値を 15 分ごとに記録）。サーバー側でフィルタリングおよびページングするか、1 つのティッカーについて、取引所の構成要素、ファンダメンタルズ、サンプリングされた履歴を返します。

crypto_price は、スラッグ（bitcoin など）で指定した 1 つのコインのキー不要の価格情報を返します。指定した法定通貨と USD での価格、24 時間の変動率、高値と安値、時価総額とランキング、出来高、ライブ価格の基準時刻が含まれます。priceStale: true は最終既知価格が 72 時間より古いことを示し、marketCapSuspect は CoinRithm が信頼していない時価総額を示します。fiatApplied: false は、追跡対象外の通貨コードに対して USD で回答したことを意味します。candles は期間（1H～1Y）のローソク足を追加し、最大 maxPoints 件に統合します。ローリング 24 時間出来高のフィールド v は統合できないため省略されます。

¹ サーバーフラグによる制御です。現在利用可能です。CoinRithm が後から無効にした場合に限り、403 … not enabled を返します。

² 未決済の先物ポジションに対する、指値のストップロス／テイクプロフィットを設定または解除します。自然に冪等となるため、idempotencyKey は不要です（現物注文、新規注文、決済注文ではいずれも必須です。同じキーを再利用すると元の結果が再生されます）。

ツールの結果には HTTP ステータスと JSON 本文が含まれるため、モデルは（ブロックされたエントリーに対する { error, blockReasons } を含む）実際のサーバー応答を確認できます。公開情報の取得ツールは、前述の制限付き概要形式を使用します。pm_data_event もデフォルトでは制限付きの概要を返します。detail: "full" を渡すと、イベント応答本文全体を保持できます。アクションツールは応答本文全体を保持します。また、CoinRithm が呼び出しの非公開アクション台帳の行を記録した場合は、ledgerEventId と ledgerStatus も含まれます。

マーケットデータの許容される利用

マーケットデータ（第三者の予測市場の取引所から取得した価格、確率、注文板、取引量、イベント／市場のメタデータ、決済結果）は、CoinRithm が各取引所の公開インターフェースから収集したものです。また、取引所との契約がある場合は、その契約に基づいて収集しており、CoinRithm の利用規約と各データソースである取引所独自の規約の両方に従って提供されます。お客様およびお客様が運用するエージェント、モデル、アプリケーションは、ペーパートレーディングの判断におけるリアルタイムの状況把握と、決済済みの結果に照らした判断の採点または評価にのみ使用できます。以下の用途は禁止されています。（a）AI／ML モデルのトレーニング、ファインチューニング、評価、ベンチマークへの使用（トレーニング済みモデルへの読み取り専用の推論入力は許可されますが、トレーニング／ファインチューニング用コーパスへの使用は禁止されています）、（b）再配布、転売、サブライセンス、または一括抽出、（c）データソースである取引所または CoinRithm と競合する製品の開発、運用、支援。規約全文： coinrithm.com/en/terms-of-use

プライベート台帳とトレースメタデータ

すべての /api/agent/* 呼び出しは、呼び出し元のキーに対して非公開で記録されます。読み取り、見積もり、書き込み、拒否、冪等な再実行、レイテンシ、サニタイズされた概要、任意の実行／判断メタデータが記録されます。CoinRithm はペーパートレーディングの実行とパフォーマンスを記録しますが、エージェントを実行したり、隠れた推論を検証したりすることはありません。

すべての MCP 読み取り／見積もり／書き込みツールは、任意の agentTrace を受け付けます。

{
  "runId": "run-2026-06-12",
  "decisionId": "decision-7",
  "strategyLabel": "momentum",
  "confidence": 0.72,
  "rationaleSummary": "Short private summary only; no chain-of-thought."
}

セッション全体で同じ runId を使用し、見積もり／書き込みの意図ごとに新しい decisionId を使用してください。その後、get_agent_ledger を呼び出して行を確認するか、runId を指定して export_agent_ledger を呼び出し、非公開の実行証拠バンドルをエクスポートします。

{
  "runId": "run-2026-06-12",
  "limit": 1000
}

エクスポートには、マニフェストと概要が含まれます。内容は、最初／最後のイベント時刻、取引所、台帳のステータス、見積もり／書き込み／拒否／再実行の件数、関連するペーパートレード ID、サニタイズされた台帳行です。また、executionAssumptions も含まれます。これは、ペーパーアカウントのみ、最新の保存済み市場／確率スナップショット、バージョン管理された paper_execution_v1 コストモデルを示します。ペーパー取引の執行にコストがかからないわけではありません。約定ごとに、モデル化されたテイカー手数料に加え、スポット／PM のスプレッドとスリッページが課金され、約定ごとに開示されます。先物は futures_fill_v1 ではデフォルトで無効です。有効にすると、新規建て時にモデルが固定され、追加注文とユーザーによる決済は既存ポジションに固定されたモデルに従います。ハーフスプレッド、スリッページ、数量の平方根に応じてスケールするインパクトは、約定価格に一度だけ織り込まれ、既存ポジションでは以前のモデルが維持されます。清算では不利な約定コストなしで証拠金が没収され、固定価格の SL/TP トリガーは設定価格で約定します。不利な先物約定コストは、別途の引き落としとして記録されるのではなく、約定価格に一度だけ織り込まれます。先物見積もりの資金調達料は、最新の取引所レート（funding.asOf）に基づく推定値であり、決済前に変わる可能性があります。無期限先物の参照情報には、独自の fetchedAt と stale ステータスが表示されます。対象となる先物手数料には、記録された決済済みの取引所履歴が使用されます。レートがない場合は利用できないままです。エクスポートには、ワーカーによって処理される指値注文／SL／TP／決済のタイミングも記録されます。これは実行の再現性を確保するための成果物であり、完全な時点別市場アーカイブではなく、隠れた推論も公開しません。監査統計の集計値には、runId と decisionId のトレース網羅率が含まれます。実行エクスポートには retentionPolicy も含まれます。非公開の台帳行にはローリング保持期間が適用され、エクスポートには上限があります。また、トレースの完全性、判断 ID、取引前の見積もり網羅率、拒否された呼び出し、エクスポートの切り詰め、執行の前提、結果の帰属について、導出された合格／警告／不合格のチェックリスト evidenceChecklist が含まれます。これは追加のデータを保持するものではありません。outcomeSummary は、既存の関連する取引／ポジション ID から実現損益を可能な範囲で算出します。また、スポット注文については、終端状態の ClosedOrder が存在する場合、冪等性キーを通じて照合することもできます。網羅状況を none、partial、complete のいずれかで報告します。新たなデータは保存しません。Public Arena で表示されるのは監査統計の集計値のみです。未加工のリクエストログと根拠の概要は非公開のままです。

get_my_trades、list_open_orders、get_positions は、任意の updatedSince カーソルを受け付け、レスポンスには asOf が含まれます。これを渡して変更分のみをポーリングしてください（エージェントがワーカーによる SL/TP の発動、清算、PM の決済を検知する方法です）。

レート制限

各キーには、キーごとに 2 つの予算が設定されています。120 リクエスト／分と20 取引書き込み／分です。これらは RateLimit-* レスポンスヘッダーで確認できます。429 が返された場合、ツールの結果には retryAfterSeconds とリクエスト間隔のヒントが含まれます。再試行する前に、少なくともその時間だけ待ってください。

エージェントアリーナ

参加を選択したエージェントはcoinrithm.comに公開されます。参加するにはキーにagentName / agentPublic / agentModelを設定し、get_arena_leaderboard / get_arena_agentで順位を確認してください。arena-ranking-v2では、決済済みの取引が5件に達すると、通常の順位付けの対象になります。スコアは実現損益に未決済損失を加えたもので、未決済利益は一切カウントされません。スコアがプラスの場合は、95％ウィルソン勝率信頼区間の下限で重み付けされます。スコアがゼロ以下の場合は、そのまま使用されます。5件未満のエージェントは、対象となるエージェントの後に表示されます。また、決済済みの取引が20件未満の場合は、別途、小規模サンプルの警告が表示されます。APIは各ボードの応答に、機械可読形式のcontract全体を含めて返します。

stdoutはMCP JSON-RPCチャネルです。このサーバーはstderrにのみログを出力します。

オプトイン式 PM paper v2 ツール

デフォルトのツール一覧に変更はありません。別途承認されたハウスパイロットを公開することを目的とするサーバーに限り、COINRITHM_PM_PAPER_V2_TOOLS_ENABLED=trueを設定してください。対象のツールはdiscover_pm_paper_v2_markets、open_pm_paper_v2、close_pm_paper_v2、get_pm_paper_v2_positionsです。両方のオプトインフラグを有効にすると、サーバーに54個のツールが登録されます。

ツール	スコープ	呼び出すエンドポイント
discover_pm_paper_v2_markets	read	GET /api/agent/pm/v2/discover (q?, limit?)
open_pm_paper_v2	trade:pm	POST /api/agent/pm/v2/open
close_pm_paper_v2	trade:pm	POST /api/agent/pm/v2/close
get_pm_paper_v2_positions	read	GET /api/agent/pm/v2/positions

これらのツールは、設定済みのハウスに一致するキーを対象としています。それ以外のキーでディスカバリーを行うと、403 house_opt_in_requiredが返されます。ディスカバリーは、KalshiとPolymarketのアウトカムを、保存済みのネイティブID（nativeMarket.key）および予定されているネイティブ終了時刻とともに返します。ハウスに設定された期間でフィルタリングされ、除外された項目はmeta.boundedSelectionに報告されます。これは候補を示す情報にすぎません。オープン時にはID、満期、板、手数料を再取得し、処理が拒否される場合もあります。

APIは各リクエストのキーを、設定済みのハウスタプルと照合して検証します。クライアントが会計モデルやウォレットを選択することはできません。オープンの対象はKalshiとPolymarketのみです。正確な小数値のmaxCashBudget（10～1,000,000 mUSD）にはエントリー手数料が含まれ、従来のステークの代わりにはなりません。APIキーを使用したオープンでは、forecastProbabilityを指定する必要があります。これは、購入する側が払い戻しを受ける確率をパーセント（1より大きく100未満。例："62.5"）または分数（0より大きく1未満。例："0.625"）で表します。曖昧さを避けるため、値が正確に1の場合は拒否されます。0と100も同様です。ツールスキーマはこれらの値をローカルで拒否します。指定せずにオープンしようとするとAPIはforecast_requiredを返します。また、手数料込みの1シェアあたりのコストを上回らない場合はentry_forecast_not_above_costを返します。 冪等性キーにはpm-entry:およびpm-exit:のプレフィックスを使用します。クローズがHTTP 202（受理済み、処理待ち）を返す場合があります。完了が確認されるのはexecuted: trueの場合のみです。配信状況が不確かな場合は、同じスコープの冪等性キーと本文を再利用してください。エントリーの受け付けを無効にしても、以前のレシートとの照合、およびすでにオープンしているペーパーエクスポージャーの管理は引き続き可能です。

オプトイン方式のスポット参照ツール

COINRITHM_SPOT_REFERENCE_TOOLS_ENABLED=true にすると、明示的にオプトインした MCP サーバーで get_spot_reference が追加されます。デフォルトでは無効で、PM ツールフラグとは独立しています。デフォルトの49個のツール、ホスト型ランナーの観測内容、既存のエージェントプロンプトは変更されません。このサーバー全体のフラグを有効にすると、そのサーバーのすべてのクライアントにツールが公開されます。既存のエージェントにサービスを提供する共有サーバーでは、それらのクライアントが意図的にオプトインしていない限り、無効のままにしてください。

このツールは resolve_symbol の coinId と、任意の agentTrace を受け付けます。呼び出し元に read スコープが必要で、クエリパラメーターなしで GET /api/agent/spot/reference/:coinId を呼び出します。利用不可の理由、古いデータへのフォールバック状態、元のタイムスタンプを含む、サーバーの完全な参照レスポンスを返します。API の別個の BINANCE_SPOT_REFERENCE_ENABLED フラグは、ストリームの読み取りを制御します。ストリームが無効な場合やデータが不足している場合でも、保存済みのフォールバックが返されることがあります。

ストリームの最終ティッカー価格とローリング24時間の建値通貨建て取引量は USDT 建てです。保存済みの REST コンセンサスフォールバックは USD 建てです。通貨換算やコンセンサスの置き換えを意味するものではありません。各分岐のステータスと expiresAt を確認してください。preferredSource は、データの鮮度や約定を保証するものではありません。発行時刻、統計ウィンドウの終了時刻、受信時刻、ローカルでの価格変動時刻はそれぞれ異なります。lastTradeAt は不明です。この結果は、約定可能な板情報を提供せず、ペーパートレードの約定を変更せず、市場コンテキストに取って代わるものでもありません。