@coinrithm/mcp-trading 0.7.5 → 0.7.7

package/dist/tools.js

@@ -492,6 +492,34 @@ export function compactPublicPmWhales(data, limit) {
         : data.trades;
     return { ...data, trades };
 }
+// Crypto movers rows arrive as {ucid, symbol, name, slug, change24h,
+// currentPrice} with the numerics as STRINGS (backend SQL fn passthrough).
+// Coerce so a brain never string-compares "9.5" > "12"; drop the internal
+// ucid. A row that fails coercion passes through untouched — honesty over
+// polish, same rule as every other compactor here.
+export function compactPublicCryptoMovers(data) {
+    if (!Array.isArray(data))
+        return data;
+    return data.map((row) => {
+        if (!isJsonRecord(row))
+            return row;
+        const change = Number(row.change24h);
+        const price = Number(row.currentPrice);
+        return {
+            // coinId IS the ucid the rest of the tool surface takes (get_candles,
+            // get_market_context, the futures quote/open path). Carrying it through
+            // is not cosmetic: without it the caller has to re-derive the coin from
+            // the SYMBOL via resolve_symbol, and symbols collide across listings —
+            // the round-trip can land on a different coin than the one that moved.
+            coinId: row.ucid,
+            symbol: row.symbol,
+            name: row.name,
+            slug: row.slug,
+            change24hPct: Number.isFinite(change) ? change : row.change24h,
+            priceUsd: Number.isFinite(price) ? price : row.currentPrice,
+        };
+    });
+}
 const MATCH_PAIR_FIELDS = [
     "matchId",
     "confidence",
@@ -943,16 +971,16 @@ export function registerTools(server, client) {
     }, async ({ runId, agentTrace }, extra) => present(await client.exportLedger({ runId }, requestKey(extra), agentTrace)));
     server.registerTool("get_arena_leaderboard", {
         title: "Get Agent Arena leaderboard",
-        description: "The public Agent Arena: opted-in agents ranked by total realized PnL " +
-            "(mUSD) across spot, futures, and prediction markets, with per-venue " +
-            "breakdown and win rate. Only agents with at least minDecidedTrades " +
-            "decided (win+loss) trades rank (currently 3 — echoed in the " +
-            "response); demo/house agents seed the board until live agents " +
-            "qualify. Rows also carry a 44-day sparkline, badges, rankDelta, " +
-            "biggestWinMusd, and the self-reported model label. Pass " +
-            "window='7d'|'30d' for the weekly/monthly board — re-ranked by PnL " +
-            "realized inside the window (badges/biggestWin and the min-decided " +
-            "gate stay all-time). Use it to see the field and where you stand — pair " +
+        description: "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_NOTE,
@@ -1757,4 +1785,32 @@ export function registerTools(server, client) {
         outputSchema: API_RESULT_OUTPUT_SCHEMA,
         annotations: readOnlyAnnotations("Global prediction-market volume trend"),
     }, async () => present(await client.getPublicPmVolumeHistory()));
+    server.registerTool("get_crypto_movers", {
+        title: "Top 24h crypto movers (universe scan)",
+        description: "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) and get_market_context " +
+            "(sentiment, 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.",
+        inputSchema: {
+            direction: z
+                .enum(["gainers", "losers"])
+                .optional()
+                .describe("Scan direction (default gainers)."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Rows to return, 1-100 (default 20)."),
+        },
+        outputSchema: API_RESULT_OUTPUT_SCHEMA,
+        annotations: readOnlyAnnotations("Top 24h crypto movers"),
+    }, async ({ direction, limit }) => present(mapSuccessfulBody(await client.getPublicCryptoMovers(direction ?? "gainers", limit ?? 20), compactPublicCryptoMovers)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinrithm/mcp-trading",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "mcpName": "io.github.CoinRithm/mcp-trading",
   "description": "CoinRithm paper-trading toolkit: an MCP server (coinrithm-mcp) AND a self-host agent runner (coinrithm-agent) for spot, futures, and prediction markets with a user-minted API key.",
   "type": "module",