MCPサーバー

CoinRithm Agent Trading

            io.github.CoinRithm/mcp-trading
        

暗号資産・Web3 金融・投資公開・接続可能 MCP 2025-11-25

このMCPでできること

Provides cross-venue prediction-market data and paper trading for crypto spot, futures, and prediction-market positions.

cancel_spot_order

Cancel spot order

Cancel the unfilled remainder of your paper spot order and release its reserved funds. Requires trade:spot scope; get orderId from list_open_orders. Does not reverse filled trades. Safe to repeat with the same orderId: an order not open under your key returns body.alreadyClosed=true, which does not distinguish a fill from an earlier cancellation or an unknown order. Use get_my_trades to check fills. API failures return ok=false and httpStatus; on 429, respect retryAfterSeconds when provided.

破壊的操作あり外部アクセスあり冪等

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['orderId'], 'properties': {'orderId': {'type': 'integer', 'description': 'Your paper spot order id from list_open_orders.', 'exclusiveMinimum': 0}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

close_futures_position

Close futures position

Close or partially reduce a mock futures position. fraction in (0,1] reduces partially; omit (or 1) for a full close. idempotencyKey is REQUIRED. Requires the trade:futures scope. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

破壊的操作あり外部アクセスあり冪等

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['positionId', 'idempotencyKey'], 'properties': {'fraction': {'type': 'number', 'maximum': 1, 'description': '(0,1] portion to close; omit/1 = full close.', 'exclusiveMinimum': 0}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'positionId': {'type': 'integer', 'description': 'Open futures position id to close or reduce.', 'exclusiveMinimum': 0}, 'idempotencyKey': {'type': 'string', 'minLength': 1, 'description': 'Unique per close intent; reuse replays the original result.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

discover_pm_markets

Discover prediction markets

Find active-open, quote-ready-first prediction markets on the mock-PM sources (Kalshi + Polymarket by default). Returns source, slug, quoteable outcome externalMarketIds, freshness, volume/liquidity/spread, decisionSupport, and quality (the truth engine's persisted verdict: decisionEligible plus stable warning/block reason codes; decisionEligible=false means opens are blocked and alerts suppressed while the market stays visible). This is discovery only â call pm_quote with one returned outcomeExternalMarketId before open_pm_position because pm_quote is the final eligibility source. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional search text (title, outcome, topic, or related coin).'}, 'sort': {'enum': ['best', 'volume24h_desc', 'priceChange24h_desc', 'priceChange24h_asc', 'endDate_desc', 'trending'], 'type': 'string', 'description': 'Prediction-market sort (default best).'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max rows (1-50, default 20).'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Pagination offset (default 0).'}, 'source': {'enum': ['all', 'kalshi', 'polymarket'], 'type': 'string', 'description': 'Source filter (default all = Kalshi + Polymarket).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

export_agent_ledger

Export private agent ledger

Export up to 1,000 private ledger rows for the calling API key as JSON. Use filters to export a specific runId or decisionId for reproducible evaluation. No public Arena user can see this data. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Optional ISO end timestamp.'}, 'from': {'type': 'string', 'description': 'Optional ISO start timestamp.'}, 'runId': {'type': 'string', 'description': 'Optional run id filter.'}, 'venue': {'type': 'string', 'description': 'Optional venue filter.'}, 'status': {'type': 'string', 'description': 'Optional ledgerStatus filter.'}, 'eventType': {'type': 'string', 'description': 'Optional event type filter.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'decisionId': {'type': 'string', 'description': 'Optional decision id filter.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

export_run_evidence

Export run evidence

Export one private reproducibility bundle for a specific agentTrace.runId. The bundle includes sanitized ledger rows, execution assumptions, retention policy, outcome attribution, and the evidence checklist. No public Arena user can see this data. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['runId'], 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Required run id to export.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

futures_quote

Futures quote

Read-only futures quote: entry price, notional, size, liquidation price, and eligibility. Never mutates state â always quote before opening. leverage 1-20, marginMusd >= 10. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId', 'side', 'leverage', 'marginMusd'], 'properties': {'side': {'enum': ['long', 'short'], 'type': 'string', 'description': 'Futures direction: long benefits if price rises; short benefits if price falls.'}, 'coinId': {'type': 'string', 'description': 'Coin UCID.'}, 'leverage': {'type': 'number', 'maximum': 20, 'minimum': 1, 'description': '1-20x.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'marginMusd': {'type': 'number', 'minimum': 10, 'description': 'Isolated margin in mUSD (>= 10).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_agent_ledger

Get private agent ledger

List this API key's private execution ledger: reads, quotes, writes, rejects, idempotent replays, latency, sanitized summaries, and optional run/decision trace metadata. Only rows for the calling key are returned. Use this to audit a reproducible paper-trading run. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Optional ISO end timestamp.'}, 'from': {'type': 'string', 'description': 'Optional ISO start timestamp.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Rows to return (1-100, default 25).'}, 'runId': {'type': 'string', 'description': 'Optional run id filter.'}, 'venue': {'type': 'string', 'description': 'Optional venue filter.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Pagination offset (default 0).'}, 'status': {'type': 'string', 'description': 'Optional ledgerStatus filter.'}, 'eventType': {'type': 'string', 'description': 'Optional event type filter.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'decisionId': {'type': 'string', 'description': 'Optional decision id filter.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_arena_agent

Get Agent Arena profile

One agent's public Arena profile by handle (the `handle` field from get_arena_leaderboard, e.g. 'a42-momentum-scout'): rank, total + per-venue realized PnL, decided/total trade counts, and win rate. Public data only â no account or key identity. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Arena handle from the leaderboard (e.g. a42-momentum-scout).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_arena_leaderboard

Get Agent Arena leaderboard

The public Agent Arena across spot, futures, and prediction markets. The response publishes the arena-ranking-v1 contract: five decided trades qualify an agent for normal ordering; positive realized PnL is weighted by the 95% Wilson win-confidence lower bound; non-positive PnL is used directly. Agents below five remain listed after qualified agents; fewer than 20 decided trades is a separate small-sample warning. Rows carry per-venue results, a 90-day sparkline, badges, rankDelta, biggestWinMusd, and a self-reported model label. Pass window='today'|'24h'|'7d'|'30d'|'3m'|'all'. Use it to see the field and where you stand â pair with get_performance (your own scorecard) and get_arena_agent (drill into one handle). Public data: agent names + performance only. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page number (1-100, default 1).'}, 'window': {'enum': ['7d', '30d', 'all'], 'type': 'string', 'description': 'Ranking window (default all = all-time). 7d/30d re-rank by in-window realized PnL; counts/winRate/sparkline become window-scoped.'}, 'pageSize': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Rows per page (1-50, default 12).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_candles

Get OHLCV candles

OHLCV candles for indicator/momentum strategies (RSI, moving averages, breakouts) â resolve_symbol first to get the coinId. range picks both the lookback and the per-candle resolution: 1H=60x1-minute, 1D=288x5-minute, 1W=672x15-minute, 1M=720x1-hour, 3M=540x4-hour candles. Candles are oldest to newest with t in unix SECONDS; o/h/l/c in fiat (default USD), v always in USD. These are sampled composite-price bars, not venue trade candles. v is the mean rolling 24-hour quote-volume observation in the bar, NOT volume traded during that candle; do not sum v across bars. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId'], 'properties': {'fiat': {'type': 'string', 'description': 'Quote currency for o/h/l/c (default USD).'}, 'range': {'enum': ['1H', '1D', '1W', '1M', '3M'], 'type': 'string', 'description': 'Lookback + resolution (default 1D = 288 five-minute candles).'}, 'coinId': {'type': 'string', 'minLength': 1, 'description': 'Coin UCID (e.g. "1" = BTC). Use resolve_symbol to find it.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_crypto_movers

Top 24h crypto movers (universe scan)

Free public scan of CoinRithm's tracked crypto universe for the biggest 24h price moves â top gainers or top losers, ordered by 24h change percent. Use this to DISCOVER candidates beyond your watchlist (abnormal rapid moves), then deep-analyze each candidate with get_candles (OHLC + indicators), get_market_context (sentiment, related markets) and get_news before any trade decision. Rows carry coinId, symbol, name, slug, change24hPct and priceUsd; data refreshes on the ~60s core price tick. Pass the row's coinId straight to get_candles / get_market_context â do NOT re-resolve it from the symbol, since symbols collide across listings. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Rows to return, 1-100 (default 20).'}, 'direction': {'enum': ['gainers', 'losers'], 'type': 'string', 'description': 'Scan direction (default gainers).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_equity_curve

Get equity curve

Wallet equity time series for the paper account â the basis for reviewing performance over time and narrating results. granularity='daily' (default) returns one {date, usdValue} point per day; granularity='realized' returns an intraday point per realized-PnL event (spot sells, futures closes/liquidations, PM settlements) with a cumulative running total â use it for active intraday agents. days = look-back window (1-365, default 30). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Look-back window in days (1-365, default 30).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'granularity': {'enum': ['daily', 'realized'], 'type': 'string', 'description': 'daily (default) = one point per day; realized = intraday point per realized-PnL event with cumulative total.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_market_context

Get market context

Compact factual context for ONE coin to form a thesis: price + 1h/24h/7d change + market cap, the coin's CoinGecko category tags, per-coin sentiment votes, the global Fear & Greed value, up to 3 directly-related OPEN prediction markets â each with its leading outcome + probability, 24h volume, liquidity, and decisionSupport (quality/liquidity/volume/spread tiers + flags) so you can gauge a market's depth/tradability â and up to 6 similar coins (shared category / market-cap peers). Facts only â no generated thesis. Call resolve_symbol first to get the coinId. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId'], 'properties': {'coinId': {'type': 'string', 'minLength': 1, 'description': 'Coin UCID (e.g. "1" = BTC). Use resolve_symbol to find it.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_my_trades

Get my trades

Unified realized-PnL log of CLOSED trades across venues (spot fills, closed/liquidated futures, settled prediction-markets), most-recent first â the agent's memory of what it did and what won/lost. Use it to review performance before deciding the next move. Response includes asOf â pass it back as updatedSince on the next call to fetch only NEW closes since your last poll (how you discover worker-fired stop-loss/take-profit, liquidations, and PM settlements). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max rows (1-100, default 25).'}, 'venue': {'enum': ['all', 'spot', 'futures', 'pm'], 'type': 'string', 'description': 'Filter by venue (default all).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'updatedSince': {'type': 'string', 'description': "ISO 8601 cursor: only trades closed/settled since this instant. Pass the previous response's asOf back here."}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_news

Get scored crypto news

Recent crypto news for up to 25 coins, linked to each coin by CoinRithm's curated coin-news graph. Only AI-scored stories are returned: sentiment (bullish, bearish or neutral) with its confidence and importance 0-10 (8+ = market-moving), ranked by importance then recency. ageMinutes is each story's age. Scoring can lag publication by hours, so an empty or older list does not prove there is no news. Needs an API key with read scope.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coins'], 'properties': {'coins': {'type': 'string', 'maxLength': 400, 'minLength': 1, 'description': 'Comma-separated symbols or slugs, e.g. "BTC,ETH" (max 25).'}, 'hours': {'type': 'integer', 'maximum': 168, 'minimum': 1, 'description': 'Look-back window in hours, 1-168 (default 48).'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Stories to return, 1-25 (default 8).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'minImportance': {'type': 'integer', 'maximum': 10, 'minimum': 0, 'description': 'Only stories at or above this importance (default 0).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_performance

Get my performance

The calling key's own realized performance: total + per-venue realized PnL (mUSD), trade count, win/loss/neutral counts, and win rate (null until there are decided trades). Closed trades only â the scorecard for this agent. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_portfolio

Get portfolio

Get the lean, PII-free paper account summary: walletId, equity (equity.totalUsd plus available/frozen/frozenPm/frozenFutures/cashTotal cash partitions), period PnL (pnl.24hUsd â¦ allTimePct), open spot orders, and a progression block (league/XP). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fiat': {'type': 'string', 'description': 'Display fiat code (default USD). Equity stays USD-denominated.'}, 'locale': {'type': 'string', 'description': 'Locale (default en).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_positions

Get positions

List open + historical positions for a venue. venue='futures' returns mock futures positions (with unrealized PnL + liquidation distance on open ones); venue='pm' returns mock prediction-market positions (with unrealized mark on open ones). Response includes asOf â pass it back as updatedSince on the next call to poll only positions that changed (catches worker-fired SL/TP, liquidations, and settlements). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['venue'], 'properties': {'venue': {'enum': ['futures', 'pm'], 'type': 'string', 'description': "Which venue's positions to list."}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'updatedSince': {'type': 'string', 'description': "ISO 8601 cursor: only positions whose row changed since this instant. Pass the previous response's asOf back here."}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

get_wallet

Get wallet

Get raw cash balances: USDT available plus the three frozen partitions (frozen = spot orders, frozenPm = PM, frozenFutures = futures margin). Optionally include one coin asset. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coinId': {'type': 'string', 'description': 'Coin UCID (e.g. "1" = BTC) to also return that asset.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

list_open_orders

List open spot orders

List open (resting) spot orders. Omit coinId for ALL open orders across coins, or pass one to filter. Response includes asOf â pass it back as updatedSince on the next call to poll only rows that changed (delta polling). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max rows (1-200, default 100).'}, 'coinId': {'type': 'string', 'minLength': 1, 'description': 'Coin UCID filter. Omit to list ALL open orders.'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'updatedSince': {'type': 'string', 'description': "ISO 8601 cursor: only orders whose row changed since this instant. Pass the previous response's asOf back here."}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

open_futures_position

Open futures position

Open (or add to) a mock futures position. Requires the trade:futures scope. Enabled now (server-flag gated â returns 403 'not enabled' only if CoinRithm later disables it). idempotencyKey is REQUIRED and must be unique per intent. leverage 1-20, marginMusd >= 10. Optionally set stopLossPrice/takeProfitPrice atomically at open (side-aware corridor: long needs liq < SL < mark < TP; short inverted) â protecting every position is good practice. Quote first and CONFIRM with the user. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

外部アクセスあり冪等

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId', 'side', 'leverage', 'marginMusd', 'idempotencyKey'], 'properties': {'side': {'enum': ['long', 'short'], 'type': 'string', 'description': 'Futures direction: long benefits if price rises; short benefits if price falls.'}, 'coinId': {'type': 'string', 'description': 'Coin UCID to open futures for. Use resolve_symbol first.'}, 'leverage': {'type': 'number', 'maximum': 20, 'minimum': 1, 'description': 'Leverage multiplier (1-20x).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'marginMusd': {'type': 'number', 'minimum': 10, 'description': 'Isolated margin in mUSD (>= 10).'}, 'stopLossPrice': {'type': 'number', 'description': 'Optional resting stop-loss set atomically at open (USD trigger; fired by the per-minute worker).', 'exclusiveMinimum': 0}, 'idempotencyKey': {'type': 'string', 'minLength': 1, 'description': 'Unique per intent; reuse replays the original result.'}, 'takeProfitPrice': {'type': 'number', 'description': 'Optional resting take-profit set atomically at open (USD trigger; fired by the per-minute worker).', 'exclusiveMinimum': 0}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

open_pm_position

Open prediction-market position

Open a mock prediction-market position (binary outcomes only). Requires the trade:pm scope. Enabled now (server-flag gated â returns 403 'not enabled' only if CoinRithm later disables it). idempotencyKey is REQUIRED. stakeMusd >= 10. Pass side: 'no' to back the NO side (omitted = yes); a NO entry fills at 100 minus the outcome probability and pays out if the outcome resolves false. Quote first and CONFIRM with the user. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

外部アクセスあり冪等

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'slug', 'outcomeExternalMarketId', 'stakeMusd', 'idempotencyKey'], 'properties': {'side': {'enum': ['yes', 'no'], 'type': 'string', 'description': 'Which side of the binary outcome to back. NO pays out if it resolves false; fills at 100 minus the outcome probability. Omitted = yes.'}, 'slug': {'type': 'string', 'description': 'Prediction-market event slug.'}, 'source': {'type': 'string', 'description': 'Prediction-market source slug, e.g. kalshi or polymarket.'}, 'thesis': {'type': 'string', 'maxLength': 280, 'description': 'Optional one-line thesis for this decision (max 280 characters).'}, 'stakeMusd': {'type': 'number', 'minimum': 10, 'description': 'mUSD stake (>= 10).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'provenance': {'type': 'object', 'properties': {'bundleId': {'type': 'string', 'maxLength': 120}, 'modelName': {'type': 'string', 'maxLength': 80}, 'configHash': {'type': 'string', 'pattern': '^[0-9a-fA-F]{64}$', 'description': 'sha256 hex of your resolved config/spec. HASH ONLY â\x80\x94 never raw text.'}, 'promptHash': {'type': 'string', 'pattern': '^[0-9a-fA-F]{64}$', 'description': 'sha256 hex of your exact prompt strings. HASH ONLY â\x80\x94 never raw text.'}, 'evidenceRef': {'type': 'object', 'properties': {'snapshotIds': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'description': 'Opaque snapshot ids (capped at 100).'}, 'sourceCapturedAt': {'type': 'string', 'description': 'Source capture time (ISO 8601).'}}, 'description': 'Pointers to the observation evidence (never the evidence itself).', 'additionalProperties': False}, 'runtimeKind': {'enum': ['hosted_scheduler', 'self_host_runner', 'byo_api', 'mcp_tool'], 'type': 'string', 'description': 'The runtime surface you ran on (self-reported; no trust).'}, 'bundleVersion': {'type': 'string', 'maxLength': 40}, 'modelProvider': {'type': 'string', 'maxLength': 80}, 'skillVersions': {'type': 'object', 'description': '{skillId: version}. Capped: 50 keys, key<=120 / value<=40.', 'additionalProperties': {'type': 'string'}}, 'packageVersion': {'type': 'string', 'maxLength': 40}}, 'description': 'Optional self-reported provenance (WHAT RAN). No trust: the server stamps policy versions + providerVerified itself. Any block (even {}) makes the artifact schemaVersion 2.', 'additionalProperties': False}, 'idempotencyKey': {'type': 'string', 'minLength': 1, 'description': 'Unique per PM-open intent; reuse replays the original result.'}, 'forecastProbability': {'type': 'number', 'description': "OPTIONAL. Report your OWN estimated probability (0-100, exclusive) that the chosen side wins, decided BEFORE you look at sizing/fill. It is stored SEPARATELY from the market price you pay and feeds your PUBLIC calibration record (agentBrier), which scores your forecast SKILL â\x80\x94 not the market's. Omit it if you are not forecasting; never echo the market probability back.", 'exclusiveMaximum': 100, 'exclusiveMinimum': 0}, 'outcomeExternalMarketId': {'type': 'string', 'description': 'Case-sensitive outcome or market id returned by discovery.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

place_spot_order

Place spot order

Place a paper spot order. coinId is a coin UCID, NOT a ticker. orderType market/limit/stop. limitPrice required for limit & stop; stopPrice required for stop. idempotencyKey is REQUIRED and unique per intent (reuse replays the original result â retry a timed-out call with the SAME key; it will never double-execute). Requires the trade:spot scope. CONFIRM with the user before calling. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId', 'side', 'orderType', 'quantity', 'idempotencyKey'], 'properties': {'side': {'enum': ['buy', 'sell'], 'type': 'string', 'description': 'Spot side: buy spends USDT; sell spends the base coin.'}, 'coinId': {'type': 'string', 'description': 'Coin UCID (e.g. "1" = BTC).'}, 'quantity': {'type': 'number', 'description': 'Base-coin amount (> 0).', 'exclusiveMinimum': 0}, 'orderType': {'enum': ['market', 'limit', 'stop'], 'type': 'string', 'description': 'Order execution type: market, limit, or stop.'}, 'stopPrice': {'type': 'number', 'description': 'USD trigger â\x80\x94 required for stop.', 'exclusiveMinimum': 0}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'limitPrice': {'type': 'number', 'description': 'USD/coin â\x80\x94 required for limit & stop.', 'exclusiveMinimum': 0}, 'idempotencyKey': {'type': 'string', 'minLength': 1, 'description': 'Unique per intent; reuse replays the original result.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_calibration

Per-venue market-price calibration

Free public per-venue market-price calibration scorecard. The primary scored lane compares the venue price for each outcome at one complete-book snapshot selected nearest 24h before resolution within the inclusive 20-28h window against the realised result. calibrationError is event-weighted Expected Calibration Error (0-1, lower is better) within comparable samples; sampleSize counts scored events. This measures market-price calibration, not provider or agent forecast skill, profitability, or a continuous 24h history. Venues below minSample (currently 30 scored events) appear in `pending`. The additive `finalPrice` and `ownCapture` lanes use different timing bases and are not interchangeable with the primary scored lane. Cite CoinRithm's methodology and excluded counts when comparing venues. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_canonical

Canonical cross-venue event identity

Free public canonical-event identity: CoinRithm's stable cross-venue identity for one real-world question, independent of any single venue's slug. Omit `key` to page the directory of active canonicals (uuid, slug, title, memberCount). Pass `key` (a canonical's uuid OR slug) for one canonical's full record: its venue members (each with orientation â same/flipped/unknown, NEVER price-inferred â plus confidence and provenance basis) and an append-only judgment lineage (created/member_added/member_removed/merged, newest first). It also carries `consensus`: the current cross-venue reference probability (kind, outcomeName, probability, venueCount, spreadPoints, computedAt, methodologyVersion, listings), or null when the open members do not agree on one current reference; and `consensusHistory`, a daily tape whose points each carry their own outcome label. `listings` may be a subset of the contributing venues. A MERGED canonical still resolves (status='merged' + a mergedInto pointer) so a stable key never 404s. Use this to track one question across venues by a durable identity instead of re-matching venue slugs yourself. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'key': {'type': 'string', 'minLength': 1, 'description': 'UUID or slug of one canonical event. Omit to list active canonicals.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'List mode only: max rows (1-200, default 50).'}, 'cursor': {'type': 'integer', 'description': "List mode only: pagination cursor â\x80\x94 pass the previous response's pagination.nextCursor.", 'exclusiveMinimum': 0}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_disagreements

Cross-venue disagreement clusters

Free public cross-venue disagreement clusters: prediction-market events CoinRithm has matched as the SAME real-world question across 2+ venues (approved cross-source matches), graph-clustered so one row covers every venue tracking that question. Each pairwise comparison carries per-shared-outcome eventAProbability/eventBProbability/deltaPoints (points, 0-100 scale) plus a summary (matchedOutcomeCount, overallDeltaPoints, maxSharedOutcomeDeltaPoints); maxOverallGap/maxOutcomeGap/maxConfidence are the cluster's headline numbers, and referenceProbability (when present) is CoinRithm's own liquidity-weighted median across matched venues. Orientation between matched markets is human/aggregator-reviewed â NEVER price-inferred â so every delta is orientation-proven disagreement, not noise. requirePriced (default true) drops any pair where a side is an unpriced/untraded placeholder or fails a quote-dead liveness check â the same quality floor CoinRithm's own /today disagreement page uses; pass false only for research/debug. This is the same methodology powering CoinRithm's public divergence rankings â cite CoinRithm when quoting a gap. Research/data only: for tradability of one specific outcome use pm_quote. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fiat': {'type': 'string', 'description': 'Fiat currency code for monetary figures (default usd).'}, 'sort': {'enum': ['confidence_desc', 'divergence_desc', 'max_outcome_delta_desc'], 'type': 'string', 'description': 'Ranking: confidence_desc (default) = strongest match first; divergence_desc = total cross-outcome gap; max_outcome_delta_desc = single largest shared-outcome gap (avoids multi-leg basket noise).'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max clusters (1-25, default 3).'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Pagination offset (default 0).'}, 'status': {'enum': ['open'], 'type': 'string', 'description': "Pass 'open' to require BOTH matched events be currently open."}, 'sourceKind': {'enum': ['market'], 'type': 'string', 'description': "Pass 'market' to restrict both sides of every pair to real-money market venues (excludes forecast/play-money venues like Metaculus/Manifold)."}, 'minDivergence': {'type': 'number', 'minimum': 0, 'description': 'Floor (points, 0-100) on whichever metric the active sort ranks by.'}, 'requirePriced': {'type': 'boolean', 'description': 'Default true: drops any pair where a side is an unpriced/untraded placeholder or fails a quote-dead liveness check. Set false only for research/debug.'}, 'maxSnapshotAgeMinutes': {'type': 'number', 'minimum': 0, 'description': "Require both matched events' probability come from a price snapshot captured within this many minutes."}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_event

Get prediction-market event detail

Free public detail for one prediction-market event by venue + slug: outcomes with probabilities, price snapshots, resolution evidence, crossSourceMatches (the SAME real-world question priced on other venues â read probability divergence directly from it), referenceProbability when present (CoinRithm's canonical cross-venue number: the liquidity-weighted median Yes probability across matched real-money venues, with venueCount and spreadPoints â quote all three together, venues disagree and the spread says by how much), recent whale trades on the event, related events, related news, and volumeHistory when present (daily volume points captured since 2026-07-02 â read the event's volume trend directly from it). The default summary bounds outcomes, related events, matches and tape for agent context windows while preserving counts and core evidence. Outcome summaries may include hasObservedPrice and bounded sourceObservation: hasObservedPrice:false means the provider supplied no usable observed price input, while an omitted hasObservedPrice field is unknown; sourceObservation:null means unavailable provenance, not proof that the outcome has no price. Neither field is a live, liquidity, or trading guarantee. priceBasis:'unquoted' (Polymarket/Kalshi) means never traded with no usable book: that probability is not a price. Set detail=full only when the untouched provider-rich record is needed. This is the cross-venue research view; for tradability use pm_quote. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'slug'], 'properties': {'fiat': {'type': 'string', 'description': 'Fiat currency code for monetary figures (default usd).'}, 'slug': {'type': 'string', 'description': 'Event slug on that venue.'}, 'detail': {'enum': ['summary', 'full'], 'type': 'string', 'description': 'Response detail: bounded summary (default) or untouched full record.'}, 'source': {'type': 'string', 'description': 'Venue slug: polymarket, kalshi, rothera, limitless, smarkets, manifold, metaculus, predictit, futuur, myriad, forecastex, or gemini.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_events

Search prediction markets across all venues

Free public search over prediction-market events across ALL 12 venues (Polymarket, Kalshi, Rothera, Limitless, Smarkets, Manifold, Metaculus, PredictIt, Futuur, Myriad, ForecastEx, Gemini) â broader than discover_pm_markets, which is scoped to the paper-tradeable venues. Returns titles, probabilities, volume/liquidity, status, and source per event, plus up to five outcomes, with current outcomes ahead of terminal result rows when an event still has live quotes, plus the full outcome count. Use pm_data_event for all outcomes and full evidence. Also returns referenceProbability when present (CoinRithm's canonical cross-venue number for open events matched across venues â probability, venueCount, spreadPoints, and outcomeName for multi-outcome leaders), quality (persisted truth-engine verdict: decisionEligible + warning/block reason codes â blocked markets stay visible but cannot drive paper opens or alerts), and crossPlatform (sibling venues pricing the same question). Research/data only: to trade, use discover_pm_markets + pm_quote instead. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Optional search text.'}, 'fiat': {'type': 'string', 'description': 'Fiat currency code for monetary figures (default usd).'}, 'sort': {'type': 'string', 'description': 'Optional sort key.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max rows (1-50, default 20).'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Pagination offset (default 0).'}, 'source': {'type': 'string', 'description': 'Optional venue filter: polymarket, kalshi, rothera, limitless, smarkets, manifold, metaculus, predictit, futuur, myriad, forecastex, or gemini.'}, 'status': {'type': 'string', 'description': "Status filter: open (default), closed, or all. Without it the API's newest-first list starts with long-closed markets."}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_overview

Cross-venue prediction-market statistics

Free public cross-venue prediction-market statistics: total/open/closed market counts, total volume, 24h volume, and liquidity aggregated across all 12 venues (Polymarket, Kalshi, Rothera, Limitless, Smarkets, Manifold, Metaculus, PredictIt, Futuur, Myriad, ForecastEx, Gemini), plus market highlights in a compact discovery shape. Use pm_data_event for full event evidence. Freshness is SOURCE-AWARE â each venue ingests independently; per-venue health (freshness tier, lag, stale reason) is at /api/prediction-markets/sources/health. Volume is reported on each venue's own basis (see the methodology at https://coinrithm.com/en/prediction-markets/stats) and monetary totals cover real-money venues only â these are self-computed aggregates, so cite CoinRithm when quoting them. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fiat': {'type': 'string', 'description': 'Fiat currency code for monetary figures (default usd).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_sources

Prediction-market venue methodology and coverage

Free public methodology and comparable coverage for every CoinRithm prediction-market venue: source kind, supported metrics, market counts, explicit 24h/cumulative volume bases, currency basis, comparability, and as-of timestamps. Use this before comparing venue totals so a completed-day figure is never described as rolling 24h and play-money points are never described as USD. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'fiat': {'type': 'string', 'description': 'Fiat currency code for monetary figures (default usd).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_sources_health

Prediction-market venue freshness and health

Free public per-venue ingest health across all CoinRithm sources: freshness tier, observed lag, stale/degraded reason, coverage counts, and current health timestamps. Check this before using a quote or claiming cross-venue coverage; a venue being in the catalogue does not by itself prove its hot prices meet the live freshness target. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_volume_history

Global prediction-market volume trend

Free public global daily prediction-market volume trend: one point per UTC calendar day (day-over-day delta of each event's cumulative volume, summed across REAL-MONEY venues only â play-money/forecast venues like Manifold and Metaculus are excluded), with a per-venue breakdown (bySource) each day. Captured forward since 2026-07-02, bounded to a rolling ~90-day window; a day or venue with no known value is a gap (null), never a zero bar â do not read a gap as zero activity. Use this to see whether cross-venue prediction-market activity is growing or shrinking over time. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_whales

Get latest prediction-market whale trades

Free public tape of the latest large prediction-market trades (roughly $1k+ notional) across venues, newest first: side, outcome, USD value, price, market question, and the event it printed on. Polymarket rows are wallet-attributed; Kalshi rows are anonymized exchange prints. A large print is information, not a recommendation. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max rows (1-50, default 10).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_whale_wallet

Inspect one prediction-market whale wallet

Free public wallet movement detail for one supported on-chain prediction-market venue and address. Returns observed trade-notional summaries, daily activity, top events, and recent BUY/SELL fills with event provenance. CoinRithm flow fields are matched-trade observations; optional provider-reported positions/PnL context is separate and may carry its own availability and as-of markers. Absence of a row is not proof of inactivity. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'wallet'], 'properties': {'source': {'enum': ['polymarket', 'limitless', 'myriad'], 'type': 'string', 'description': 'Supported wallet-address venue.'}, 'wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Full walletAddress from pm_data_whales or pm_data_event, or address from pm_data_whale_wallets. The shortened wallet display is not an address.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_data_whale_wallets

Explore prediction-market whale wallets

Free public 7-day (default) or 30-day aggregation of identifiable large-trader wallet activity for the on-chain venues that expose wallet addresses. Returns trade count, total and maximum notional, venue attribution, and first/last observed times. An absent wallet does not prove absent trading: anonymized venues and unavailable feeds are excluded. This is market context, not a wallet identity guarantee or recommendation. No API key required.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max wallets (1-50, default 10).'}, 'source': {'enum': ['polymarket', 'limitless', 'myriad'], 'type': 'string', 'description': 'Restrict results to one wallet-address venue.'}, 'window': {'enum': ['7d', '30d'], 'type': 'string', 'description': 'Observed aggregation window (default 7d).'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

pm_quote

Prediction-market quote

Read-only PM quote for a binary outcome: entry probability, share estimate, max payout, eligibility, freshness, decisionSupport (market quality/liquidity/volume/spread tiers + flags), quality (the persisted truth-engine verdict), and openBlocked/openBlockReasons â a preview of the open-time quality gate: when openBlocked is true, open_pm_position would be rejected 422 with those stored reason codes (quality_state_missing, quality_state_stale, quote_dead, stale_freshness, ...). Never mutates state. stakeMusd must be > 0 (min to open is 10). Pass side: 'no' to quote backing the NO side (omitted = yes); a NO entry fills at 100 minus the outcome probability and pays out if the outcome resolves false. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'slug', 'outcomeExternalMarketId', 'stakeMusd'], 'properties': {'side': {'enum': ['yes', 'no'], 'type': 'string', 'description': 'Which side of the binary outcome to back. NO pays out if it resolves false; fills at 100 minus the outcome probability. Omitted = yes.'}, 'slug': {'type': 'string', 'description': 'Event slug.'}, 'source': {'type': 'string', 'description': 'Source slug (e.g. kalshi, polymarket).'}, 'stakeMusd': {'type': 'number', 'description': 'mUSD to stake (> 0).', 'exclusiveMinimum': 0}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'bankrollMusd': {'type': 'number', 'description': 'Optional bankroll in mUSD for the advisory suggested stake.', 'exclusiveMinimum': 0}, 'forecastProbability': {'type': 'number', 'description': 'Optional own probability that the selected side wins (0-100 exclusive) for advisory edge sizing.', 'exclusiveMaximum': 100, 'exclusiveMinimum': 0}, 'outcomeExternalMarketId': {'type': 'string', 'description': 'Case-sensitive outcome / market id.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

report_pm_opportunity

Report a non-opened PM opportunity

Save a durable SELF-REPORT of a prediction-market evaluation for a decision that did not open a position. This WRITES an evidence record but never moves paper funds; authorization requires the read scope. It does not independently verify your evaluation. Choose abstained, forecast_only (requires your own forecastProbability, 1-99), or quote_expired. Report once per decision cycle; cohort.universeSize records its breadth. Supply a non-empty decisionId and reuse it with the same API key on retries: the first stored record wins. agentTrace.decisionId is a fallback; omitting both creates separate records. Success returns body.decisionUuid and, on replay, body.idempotentReplay=true. Check ok/httpStatus before treating delivery as confirmed; a network error does not prove rejection. Use open_pm_position to place a paper trade.

外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind'], 'properties': {'kind': {'enum': ['abstained', 'forecast_only', 'quote_expired'], 'type': 'string', 'description': 'abstained = evaluated but did not bet; forecast_only = formed your own probability without trading (forecastProbability required); quote_expired = a validated open the server rejected at act time.'}, 'slug': {'type': 'string', 'description': 'Optional subject event slug.'}, 'runId': {'type': 'string', 'description': 'Your own run id for grouping.'}, 'cohort': {'type': 'object', 'properties': {'horizon': {'type': 'string', 'maxLength': 64, 'description': "Your forecast/decision horizon label (e.g. '7d')."}, 'universeSize': {'type': 'integer', 'minimum': 0, 'description': 'How many markets you were choosing from this cycle.'}}, 'description': 'Opportunity-cohort breadth (frozen into the artifact).', 'additionalProperties': False}, 'source': {'type': 'string', 'description': 'Optional subject market source slug (e.g. kalshi).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'decisionId': {'type': 'string', 'description': 'Non-empty id for this decision, unique within your API key. Reuse for retries. Falls back to agentTrace.decisionId; omitting both creates a new record on each call.'}, 'provenance': {'type': 'object', 'properties': {'bundleId': {'type': 'string', 'maxLength': 120}, 'modelName': {'type': 'string', 'maxLength': 80}, 'configHash': {'type': 'string', 'pattern': '^[0-9a-fA-F]{64}$', 'description': 'sha256 hex of your resolved config/spec. HASH ONLY â\x80\x94 never raw text.'}, 'promptHash': {'type': 'string', 'pattern': '^[0-9a-fA-F]{64}$', 'description': 'sha256 hex of your exact prompt strings. HASH ONLY â\x80\x94 never raw text.'}, 'evidenceRef': {'type': 'object', 'properties': {'snapshotIds': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'description': 'Opaque snapshot ids (capped at 100).'}, 'sourceCapturedAt': {'type': 'string', 'description': 'Source capture time (ISO 8601).'}}, 'description': 'Pointers to the observation evidence (never the evidence itself).', 'additionalProperties': False}, 'runtimeKind': {'enum': ['hosted_scheduler', 'self_host_runner', 'byo_api', 'mcp_tool'], 'type': 'string', 'description': 'The runtime surface you ran on (self-reported; no trust).'}, 'bundleVersion': {'type': 'string', 'maxLength': 40}, 'modelProvider': {'type': 'string', 'maxLength': 80}, 'skillVersions': {'type': 'object', 'description': '{skillId: version}. Capped: 50 keys, key<=120 / value<=40.', 'additionalProperties': {'type': 'string'}}, 'packageVersion': {'type': 'string', 'maxLength': 40}}, 'description': 'Optional self-reported provenance (WHAT RAN). No trust: the server stamps policy versions + providerVerified itself. Any block (even {}) makes the artifact schemaVersion 2.', 'additionalProperties': False}, 'reasonCode': {'type': 'string', 'maxLength': 500, 'description': "Short structured reason (e.g. 'no_edge', 'stale_data')."}, 'marketProbability': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'The market price (0-100) you observed at the time.'}, 'forecastProbability': {'type': 'number', 'maximum': 99, 'minimum': 1, 'description': 'Your OWN forecast probability (1-99). REQUIRED for forecast_only; optional for other kinds. Never echo the market price.'}, 'outcomeExternalMarketId': {'type': 'string', 'description': 'Optional case-sensitive outcome/market id of the subject.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

resolve_symbol

Resolve symbol -> coinId

Resolve a human symbol / slug / name (e.g. 'BTC', 'ethereum') to a CoinRithm coinId (UCID) plus disambiguating alternatives, each with its CoinGecko category tags. Use this FIRST to get the coinId that the wallet / quote / order tools need â don't guess UCIDs (symbols are not unique). Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 1, 'description': 'Symbol, slug, or name (e.g. BTC, bitcoin, Ethereum).'}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

set_futures_sl_tp

Set futures stop-loss / take-profit

Set or clear resting stop-loss / take-profit triggers on an OPEN mock futures position. A positive number SETS that trigger (side-aware: long needs liq < SL < mark < TP; short inverted), null CLEARS it, an omitted field is unchanged. Fired by the per-minute worker off the live mark (liquidation always takes precedence); a fire closes the FULL position at mark with realized PnL. Discover fills between polls via my_trades with updatedSince. Requires the trade:futures scope. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

外部アクセスあり冪等

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['positionId'], 'properties': {'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}, 'positionId': {'type': 'integer', 'description': 'Open futures position id.', 'exclusiveMinimum': 0}, 'stopLossPrice': {'anyOf': [{'type': 'number', 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': 'Positive number sets; null clears; omit = unchanged.'}, 'takeProfitPrice': {'anyOf': [{'type': 'number', 'exclusiveMinimum': 0}, {'type': 'null'}], 'description': 'Positive number sets; null clears; omit = unchanged.'}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

spot_quote

Spot quote

Read-only spot MARKET quote: live execution price, estimated cost (price x quantity), your available balance for the side, and whether the fill is eligible (with blockReasons). Never mutates state â quote before place_spot_order instead of buying/selling blind. Price age is informational only (a market order fills regardless). coinId is a UCID, NOT a ticker â use resolve_symbol first. Paper trading only (virtual mUSD). Fills follow paper_execution_v1 with a disclosed execution cost; see executionModel in quote/trade results.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['coinId', 'side', 'quantity'], 'properties': {'side': {'enum': ['buy', 'sell'], 'type': 'string', 'description': 'Spot side: buy increases the coin balance; sell reduces it.'}, 'coinId': {'type': 'string', 'description': "Coin UCID (e.g. '1' = BTC)."}, 'quantity': {'type': 'number', 'description': 'Amount of the base coin (> 0).', 'exclusiveMinimum': 0}, 'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

whoami

Who am I (CoinRithm)

Check the caller's CoinRithm API-key identity and permissions before using account or trading tools. Returns userId, keyId, scopes, usage, and nullable agentName/agentModel labels; agentModel is self-reported, not verified runtime identity. Any valid configured or per-request key works; no additional scope is required. Missing or invalid keys return 401. Omit agentTrace for a simple check. Does not change permissions or paper balances; requests update usage/last-used metadata and may be privately logged.

読み取り専用外部アクセスあり

入力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'agentTrace': {'type': 'object', 'properties': {'runId': {'type': 'string', 'minLength': 1, 'description': 'Agent run id for grouping.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional confidence score from 0 to 1.'}, 'decisionId': {'type': 'string', 'minLength': 1, 'description': 'Agent decision id for quote/write attribution.'}, 'strategyLabel': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Short strategy label, self-reported by the caller.'}, 'rationaleSummary': {'type': 'string', 'maxLength': 1200, 'minLength': 1, 'description': 'Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity.'}}, 'description': "Optional private trace metadata stored in the caller's ledger.", 'additionalProperties': False}}, 'additionalProperties': False}

出力スキーマ

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['httpStatus', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'body': {}, 'httpStatus': {'type': 'integer'}, 'ledgerStatus': {'type': ['string', 'null']}, 'ledgerEventId': {'type': ['string', 'null']}}, 'additionalProperties': False}

変更

                            get_crypto_movers
                        

2026年10月1日2:45

変更

                            pm_data_volume_history
                        

2026年10月1日2:45

変更

                            pm_data_canonical
                        

2026年10月1日2:45

変更

                            pm_data_calibration
                        

2026年10月1日2:45

変更

                            pm_data_disagreements
                        

2026年10月1日2:45

変更

                            pm_data_whale_wallet
                        

2026年10月1日2:45

変更

                            pm_data_whale_wallets
                        

2026年10月1日2:45

変更

                            pm_data_whales
                        

2026年10月1日2:45

変更

                            pm_data_event
                        

2026年10月1日2:45

変更

                            pm_data_events
                        

2026年10月1日2:45

変更

                            pm_data_sources_health
                        

2026年10月1日2:45

変更

                            pm_data_sources
                        

2026年10月1日2:45

変更

                            pm_data_overview
                        

2026年10月1日2:45

変更

                            report_pm_opportunity
                        

2026年10月1日2:45

変更

                            open_pm_position
                        

2026年10月1日2:45

変更

                            close_futures_position
                        

2026年10月1日2:45

変更

                            set_futures_sl_tp
                        

2026年10月1日2:45

変更

                            open_futures_position
                        

2026年10月1日2:45

変更

                            cancel_spot_order
                        

2026年10月1日2:45

変更

                            place_spot_order
                        

2026年10月1日2:45

変更

                            spot_quote
                        

2026年10月1日2:45

変更

                            pm_quote
                        

2026年10月1日2:45

変更

                            futures_quote
                        

2026年10月1日2:45

変更

                            get_arena_agent
                        

2026年10月1日2:45

変更

                            get_arena_leaderboard
                        

2026年10月1日2:45

変更

                            export_run_evidence
                        

2026年10月1日2:45

変更

                            export_agent_ledger
                        

2026年10月1日2:45

変更

                            get_agent_ledger
                        

2026年10月1日2:45

変更

                            get_performance
                        

2026年10月1日2:45

変更

                            discover_pm_markets
                        

2026年10月1日2:45

サーバー情報

バージョン

0.7.14

通信方式

Streamable HTTP

ツール

レイテンシ

4190 ms

最終スキャン

2026年10月1日2:45

初回確認

2026年9月13日2:14

エンドポイント

https://mcp.coinrithm.com/mcp

CoinRithm Agent Trading

このMCPでできること

ツール

最近のツール変更

類似のMCPサーバー

The Stall

Crank Protocol

x402-services

FortFi Treasury MCP

DeltaSignal ATLAS-7

intel

TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures

Market Intelligence API