@vike-io/cli 0.14.0 → 0.16.0

package/src/commands/hl.js

@@ -0,0 +1,274 @@
+import { addTool } from './tool-command.js';
+
+// One subcommand per Hyperliquid MCP tool; each takes `--view` (the first view is the default).
+// `hl_perp_top_traders` and `hl_position_match` stay under `perp`, candles under `candles`.
+// Flags carry the tool's own parameter names (--opened-within -> opened_within).
+const view = (views) => ['--view <v>', `${views.join(' | ')} (default ${views[0]})`];
+const SYMBOL = ['--symbol <s>', 'Instrument, e.g. BTC; a HIP-3 market is dex:TICKER (xyz:TSLA)'];
+const START = ['--start <t>', 'ISO-8601 UTC lower bound, e.g. 2026-10-01T00:00:00Z'];
+const END = ['--end <t>', 'ISO-8601 UTC upper bound'];
+const CURSOR = ['--cursor <c>', 'nextCursor from the previous page, verbatim'];
+const LIMIT = ['--limit <n>', 'Rows per page'];
+const OPENED = ['--opened-within <w>', 'Only positions opened within: 24h | 7d | 30d | all'];
+const AXIS = ['--axis <a>', 'Cohort ladder: size | pnl | pnl_abs'];
+const COHORT = ['--cohort <c>', 'One cohort label on --axis, e.g. whale or "3x smart" (`hl segments --view cohorts` lists them)'];
+const WINDOW = ['--window <w>', '1d | 7d | 30d | all'];
+const VAULT_WINDOW = ['--window <w>', '7d | 30d | 90d | 365d | all'];
+const ORDER = ['--order <o>', 'desc | asc'];
+const SIDE = ['--side <s>', 'buy | sell'];
+const WALLET = ['--wallet <a>', 'One wallet (0x + 40 hex)'];
+
+export function registerHl(program) {
+  const hl = program
+    .command('hl')
+    .description('Hyperliquid: cohort positioning, wallets, leaderboards, liquidations, markets, builders, vaults');
+
+  addTool(hl, 'cohort-metrics <symbol>', {
+    tool: 'hl_cohort_metrics',
+    args: ['symbol'],
+    desc: 'Hourly long/short positioning of one perp split by cohort (are whales / smart money long or short)',
+    options: [
+      ['--axis <a>', 'size | pnl | pnl_abs | tier | trade_size | pnl_unrealized (default size)'],
+      ['--hours <n>', 'Hourly buckets, newest first, max 8760 (default 168; 1-24 for a current read)'],
+      START, END, OPENED,
+      ['--label-basis <b>', 'current | point_in_time (point_in_time for any backtest)'],
+      ['--grading <g>', 'realized | realized-pit | unrealized (pnl axes only)'],
+      ['--include <list>', 'Comma list: volume, median_pnl (newest hour only)'],
+      CURSOR,
+    ],
+  });
+
+  addTool(hl, 'segments', {
+    tool: 'hl_segments',
+    desc: 'Cohort vocabulary, one cohort now, the symbol x cohort board, or one cohort hour by hour',
+    options: [
+      view(['segments', 'cohorts', 'summary', 'heatmap', 'history']),
+      ['--cohort <c>', 'One label (required by summary and history)'],
+      ['--axis <a>', 'size | pnl | pnl_abs (history: size or pnl, required)'],
+      OPENED, START, END,
+      ['--hours <n>', 'history: window length in hours (default 168)'],
+      ['--limit <n>', 'history: max hourly rows (default 5000)'],
+      ['--include <list>', 'history: leverage'],
+    ],
+  });
+
+  addTool(hl, 'wallet <address>', {
+    tool: 'hl_wallet',
+    args: ['address'],
+    desc: 'One wallet: equity, open positions, cohort labels, risk metrics and lifetime flow (or closed-trade stats)',
+    options: [view(['summary', 'trades_summary']), WINDOW, OPENED],
+  });
+
+  addTool(hl, 'wallet-activity <address>', {
+    tool: 'hl_wallet_activity',
+    args: ['address'],
+    desc: 'One wallet\'s fills, funding, ledger (deposits, withdrawals, transfers, vault events) or builder routing',
+    options: [
+      view(['fills', 'funding', 'ledger', 'builders']),
+      SYMBOL, START, END, SIDE,
+      ['--event-type <t>', 'ledger: one event type, e.g. deposit, withdraw, vaultDeposit'],
+      ['--window <w>', 'builders: 1d | 7d | 30d | all'],
+      ['--limit <n>', 'Rows per page (default 100, max 5000; builders 50, max 500)'],
+      CURSOR,
+    ],
+  });
+
+  addTool(hl, 'leaderboard', {
+    tool: 'hl_leaderboard',
+    desc: 'Traders ranked on any of 20 metrics with the full risk set, or on fills-derived trading PnL',
+    options: [
+      view(['ranking', 'flow_adjusted']),
+      ['--window <w>', '1d | 7d | 30d | all (default 30d)'],
+      ['--sort <s>', 'pnl | realized_pnl | roi | volume | trades | win_rate | profit_factor | calmar | max_drawdown | ... (default pnl)'],
+      ORDER, COHORT, AXIS,
+      ['--min-trades <n>', 'Minimum closed trades (default 3; 0 = no floor)'],
+      ['--min-win-rate <f>', 'FRACTION 0-1 (0.6 = 60%), unlike `perp top-traders`'],
+      ['--min-volume <usd>', 'Minimum total volume in USD'],
+      ['--limit <n>', 'Rows per page (default 25, max 500)'],
+      CURSOR,
+    ],
+  });
+
+  addTool(hl, 'liquidations', {
+    tool: 'hl_liquidations',
+    desc: 'Liquidation events, the share of open notional near liquidation per symbol, or one symbol\'s liquidation heatmap',
+    options: [
+      view(['fills', 'risk', 'heatmap']),
+      ['--symbol <s>', 'One symbol (required by heatmap)'],
+      ['--wallet <a>', 'fills: has this wallet been liquidated'],
+      START, END,
+      ['--direction <d>', 'fills: long | short, the side that was closed'],
+      AXIS, COHORT,
+      ['--min-value-usd <usd>', 'risk: smallest open notional a symbol needs to be ranked'],
+      ['--bins <n>', 'heatmap: price bins, 5-500 (default 50)'],
+      ['--limit <n>', 'Rows per page (fills max 5000, risk max 500)'],
+      CURSOR,
+    ],
+  });
+
+  addTool(hl, 'market', {
+    tool: 'hl_market',
+    desc: 'Open interest per symbol, one symbol\'s hourly series, size breakdown, positions, indices or large fills',
+    options: [
+      view(['open_interest', 'symbol_metrics', 'size_breakdown', 'positions', 'indices', 'large_fills', 'hourly']),
+      ['--symbol <s>', 'One symbol (required by every view but open_interest, positions and hourly)'],
+      ['--symbols <list>', 'hourly: comma-separated perps, at most 64 (close, open interest, funding, premium)'],
+      ['--days <n>', 'hourly: days back from --end, 1-400 (default 120)'],
+      WALLET, AXIS, COHORT, OPENED, START, END,
+      ['--open-only <bool>', 'positions: true (default) = latest open; false needs --start'],
+      ['--sort <s>', 'positions: size = biggest positions of one --symbol first'],
+      ['--resolution <r>', 'positions history: 5m | 1h'],
+      ['--label-basis <b>', 'symbol_metrics: current'],
+      ['--hours <n>', 'indices: window in hours; large_fills: look-back, max 24'],
+      ['--min-usd <usd>', 'large_fills: smallest fill, at least 50000'],
+      LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'builders', {
+    tool: 'hl_builders',
+    desc: 'Builder codes: leaderboard, venue-wide stats, one builder\'s profile, users, fills or series',
+    options: [
+      view(['leaderboard', 'stats', 'profile', 'users', 'fills', 'series']),
+      ['--builder <a>', 'Builder address (required by profile, users, fills, series)'],
+      ['--window <w>', '1d | 7d | 30d | all (default 30d)'],
+      ['--sort <s>', 'leaderboard: fee | volume | users | fills; users: volume | fees | pnl'],
+      ORDER, SYMBOL, SIDE, START, END,
+      ['--bucket <b>', 'series: 1h | 1d'],
+      ['--breakdown-limit <n>', 'profile: rows per breakdown, max 1000'],
+      LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'vaults', {
+    tool: 'hl_vaults',
+    desc: 'Every vault with TVL, APR, PnL and flows, platform vault stats, or deposits and withdrawals across vaults',
+    options: [
+      view(['list', 'stats', 'flows']),
+      VAULT_WINDOW,
+      ['--sort <s>', 'list: tvl | apr | pnl | return | net_flow | volume | age | leverage | top5_share'],
+      ORDER,
+      ['--status <s>', 'list: open | closed | all'],
+      ['--deposits <d>', 'list: any | open | closed'],
+      ['--min-tvl <usd>', 'list: minimum TVL in USD'],
+      ['--q <text>', 'list: part of a vault name, or an address prefix'],
+      ['--min-usd <usd>', 'flows: smallest flow in USD (default 10000)'],
+      ['--type <t>', 'flows: all | deposit | withdraw | distribution | commission'],
+      ['--smart-only <bool>', 'flows: only top-1000 all-time PnL depositors'],
+      LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'vault <vault>', {
+    tool: 'hl_vault',
+    args: ['vault'],
+    desc: 'One vault: profile, depositors, its own flows, or an equity / PnL series',
+    options: [
+      view(['profile', 'depositors', 'flows', 'series']),
+      ['--sort <s>', 'depositors: share | pnl | all_time_pnl | entered'],
+      ORDER,
+      ['--smart-only <bool>', 'depositors: only top-1000 all-time PnL wallets'],
+      ['--min-equity-usd <usd>', 'depositors: smallest equity, at least 1'],
+      VAULT_WINDOW,
+      ['--type <t>', 'flows: all | deposit | withdraw | distribution | commission'],
+      ['--bucket <b>', 'series: 1h | 1d'],
+      START, END, LIMIT, CURSOR,
+    ],
+  });
+
+  // The cross-wallet feeds (twaps, ledger, leverage-changes): `--order asc` follows a feed; resend the same
+  // filters with each nextCursor and stop on an empty page.
+  const FEED_ORDER = ['--order <o>', 'desc (default) | asc (to follow the feed)'];
+  const FEED_WINDOW = ['--start <t>', 'ISO-8601 UTC lower bound (default: 24 hours before --end, unless --wallet)'];
+
+  addTool(hl, 'orders', {
+    tool: 'hl_orders',
+    desc: 'Standing orders: resting at one instant, one wallet\'s orders over a window, or one symbol\'s order clusters',
+    options: [
+      view(['open', 'wallet', 'clusters']),
+      ['--symbol <s>', 'open: symbol and/or --wallet required; clusters: required'],
+      ['--wallet <a>', 'open: one wallet\'s resting orders'],
+      ['--address <a>', 'wallet: the wallet (required)'],
+      ['--at <t>', 'open, clusters: ISO-8601 UTC instant (default the newest snapshot)'],
+      ['--oid <n>', 'open: one order id'],
+      ['--order-type <t>', 'open: Limit | Stop Market | Stop Limit | Take Profit Market | Take Profit Limit | Trailing Stop Market'],
+      ['--created-from <t>', 'open: placed at or after (ISO-8601 UTC)'],
+      ['--created-to <t>', 'open: placed at or before (ISO-8601 UTC)'],
+      ['--from <t>', 'wallet: window start (default 7 days before --to)'],
+      ['--to <t>', 'wallet: window end (default the newest snapshot; at most 30 days)'],
+      ['--status <s>', 'wallet: open | filled | partially_filled | canceled_or_expired'],
+      ['--step-bps <n>', 'clusters: bucket width in basis points (default 10)'],
+      ['--range-pct <n>', 'clusters: half-width around the mid in percent (default 10)'],
+      ['--cohort-axis <a>', 'clusters: size | pnl | pnl_abs'],
+      ['--cohort <c>', 'clusters: one cohort label (current labels; not with --at)'],
+      LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'twaps', {
+    tool: 'hl_twaps',
+    desc: 'TWAP status lines across wallets, or one wallet\'s or one TWAP\'s',
+    options: [
+      WALLET,
+      ['--twap-id <n>', 'One TWAP: every status line of it'],
+      SYMBOL,
+      ['--status <s>', 'activated | waitingForTrigger | finished | terminated | stopped | error'],
+      FEED_WINDOW, END, FEED_ORDER, LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'ledger', {
+    tool: 'hl_ledger',
+    desc: 'Deposits, withdrawals, transfers and vault events across wallets',
+    options: [
+      WALLET,
+      ['--event-type <t>', 'One event type, e.g. deposit, withdraw, send, vaultDeposit'],
+      ['--min-usd <usd>', 'Smallest absolute amount_usd'],
+      FEED_WINDOW, END, FEED_ORDER, LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'leverage-changes', {
+    tool: 'hl_leverage_changes',
+    desc: 'Positions whose leverage or margin mode changed between two snapshots',
+    options: [
+      WALLET, SYMBOL,
+      ['--change <c>', 'up | down | mode'],
+      ['--min-leverage <x>', 'Smallest new leverage'],
+      FEED_WINDOW, END, FEED_ORDER, LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'wallet-trades <address>', {
+    tool: 'hl_wallet_trades',
+    args: ['address'],
+    desc: 'One wallet\'s closed round-trip trades, newest close first',
+    options: [SYMBOL, START, END, LIMIT, CURSOR],
+  });
+
+  addTool(hl, 'stats', {
+    tool: 'hl_stats',
+    desc: 'Hourly venue-wide perp equity, open interest and positions, or hourly perp volume',
+    options: [
+      view(['ecosystem', 'volume']),
+      ['--symbol <s>', 'volume: one symbol (omit for the whole venue)'],
+      START, END, LIMIT, CURSOR,
+    ],
+  });
+
+  addTool(hl, 'hype-holders', {
+    tool: 'hl_hype_holders',
+    desc: 'HYPE holders ranked by spot balance plus staked',
+    options: [['--order <o>', 'desc (default) | asc'], LIMIT, CURSOR],
+  });
+
+  addTool(hl, 'archive', {
+    tool: 'hl_archive',
+    desc: 'Index of the Hyperliquid Parquet archive (fills, positions), or a 7-day download link for one file (--view url)',
+    options: [
+      view(['datasets', 'url']),
+      ['--dataset <d>', 'url: fills | positions'],
+      ['--date <d>', 'url: the UTC day, YYYY-MM-DD, or latest (positions only)'],
+    ],
+  });
+}

package/src/commands/perp.js

@@ -39,7 +39,7 @@ export function registerPerp(program) {
     .requiredOption('--leverage <x>', 'Leverage from the share card (e.g. 25)')
     .requiredOption('--entry <p>', 'Entry price from the share card')
     .option('--mark <p>', 'Optional current mark price (sharpens tie-break)')
-    .option('--limit <n>', 'Max matches (default 10, max 50)', '10')
+    .option('--limit <n>', 'Max matches (default 50, max 500)', '50')
     .option('--json', 'Emit JSON')
     .action(async (opts) => {
       try {
@@ -50,7 +50,7 @@ export function registerPerp(program) {
           leverage: Number(opts.leverage),
           entry_price: Number(opts.entry),
           mark_price: opts.mark != null ? Number(opts.mark) : undefined,
-          limit: parseInt10(opts.limit, 10),
+          limit: parseInt10(opts.limit, 50),
         });
         emit(r, opts);
       } catch (err) { emitError(err, opts); }
@@ -60,12 +60,12 @@ export function registerPerp(program) {
     .command('top-traders')
     .description('Top Hyperliquid perp wallets by PnL / ROI / win rate / volume')
     .option('--window <w>', '1d | 7d | 30d | all', '30d')
-    .option('--sort <s>', 'pnl | roi | win_rate | volume | trade_count | drawdown', 'pnl')
+    .option('--sort <s>', 'pnl | roi | win_rate | volume | trade_count | drawdown | account_value | long_pnl | short_pnl', 'pnl')
     .option('--order <o>', 'asc | desc', 'desc')
     .option('--min-trades <n>', 'Minimum trade count', '3')
     .option('--min-win-rate <p>', 'Minimum win rate percent (0-100)', '0')
     .option('--min-volume <usd>', 'Minimum volume USD', '0')
-    .option('--size <n>', 'Page size (max 20)', '10')
+    .option('--size <n>', 'Page size (default 20, max 100)', '20')
     .option('--json', 'Emit JSON')
     .action(async (opts) => {
       try {
@@ -76,7 +76,7 @@ export function registerPerp(program) {
           min_trades: parseInt10(opts.minTrades, 3),
           min_win_rate: opts.minWinRate,
           min_volume: opts.minVolume,
-          size: parseInt10(opts.size, 10),
+          size: parseInt10(opts.size, 20),
         });
         emit(r, opts);
       } catch (err) { emitError(err, opts); }

package/src/commands/polymarket.js

@@ -1,24 +1,35 @@
 import { callTool } from '../mcp-client.js';
 import { emit, emitError } from '../format.js';
 import { parseInt10 } from '../util.js';
+import { addTool } from './tool-command.js';
 
 export function registerPolymarket(program) {
   const cmd = program
     .command('polymarket')
     .alias('pm')
-    .description('Polymarket prediction-market analytics (markets, traders, smart money)');
+    .description('Polymarket prediction-market analytics (markets, traders, smart money, tape, order book, settlements, archive)');
 
   cmd
     .command('markets')
-    .description('Trending Polymarket markets ranked by 24h volume')
-    .option('--category <c>', 'Crypto | Sports | Politics | Pop-Culture | Tech | all', 'all')
-    .option('--limit <n>', 'Max markets (max 30)', '10')
+    .description('Trending Polymarket markets ranked by 24h volume (or --view search / market)')
+    .option('--view <v>', 'trending (default) | search (by slug) | market (one by --condition-id)')
+    .option('--category <c>', 'trending: Crypto | Sports | Politics | Pop-Culture | Tech | all (default all)')
+    .option('--query <q>', 'search: part of the market slug')
+    .option('--active <bool>', 'search: true = only active, false = only closed')
+    .option('--offset <n>', 'search: rows to skip')
+    .option('--condition-id <id>', 'market: the condition id')
+    .option('--limit <n>', 'Max markets (trending default 10, max 30; search default 50, max 100)')
     .option('--json', 'Emit JSON')
     .action(async (opts) => {
       try {
         const r = await callTool('polymarket_markets', {
+          view: opts.view,
           category: opts.category,
-          limit: parseInt10(opts.limit, 10),
+          query: opts.query,
+          active: opts.active,
+          offset: opts.offset,
+          condition_id: opts.conditionId,
+          limit: opts.limit,
         });
         emit(r, opts);
       } catch (err) { emitError(err, opts); }
@@ -71,4 +82,93 @@ export function registerPolymarket(program) {
         emit(r, opts);
       } catch (err) { emitError(err, opts); }
     });
+
+  const FROM = ['--from-ms <ms>', 'Epoch milliseconds, inclusive'];
+  const TO = ['--to-ms <ms>', 'Epoch milliseconds, EXCLUSIVE'];
+  const CURSOR = ['--cursor <c>', 'next_cursor from the previous page'];
+
+  addTool(cmd, 'market-trades <condition_id>', {
+    tool: 'polymarket_market_trades',
+    args: ['condition_id'],
+    desc: 'One market\'s trades with the wallet behind each, newest first (one row = one order\'s fill)',
+    options: [FROM, TO, CURSOR, ['--limit <n>', 'Rows per page (default 100)']],
+  });
+
+  addTool(cmd, 'tape', {
+    tool: 'polymarket_tape',
+    desc: 'Raw L2 event tape of outcome tokens over one window of at most 24 hours, oldest first',
+    options: [
+      ['--token-id <id>', 'One outcome token id (decimal), not a condition_id'],
+      ['--token-ids <list>', 'Comma-separated outcome token ids, at most 100'],
+      ['--from-ms <ms>', 'Required. Window start, epoch ms, inclusive'],
+      ['--to-ms <ms>', 'Required. Window end, epoch ms, exclusive, at most 24h after --from-ms'],
+      ['--event-type <t>', 'book | price_change | trade | tick_size_change | status (strongly recommended)'],
+      CURSOR,
+      ['--limit <n>', 'Events per page (default 100)'],
+    ],
+  });
+
+  addTool(cmd, 'orderbook <token_id>', {
+    tool: 'polymarket_orderbook',
+    args: ['token_id'],
+    desc: 'Order-book snapshot of one outcome token at or before --ts (latest when omitted)',
+    options: [
+      ['--ts <ms>', 'As-of epoch milliseconds'],
+      ['--depth <n>', 'Levels per side, 1-25 (default 25)'],
+    ],
+  });
+
+  addTool(cmd, 'market-stats <token_id>', {
+    tool: 'polymarket_market_stats',
+    args: ['token_id'],
+    desc: 'Tape summary of one outcome token: events, trades, volume in shares, first and last recorded time',
+  });
+
+  addTool(cmd, 'settlement <condition_id>', {
+    tool: 'polymarket_settlement',
+    args: ['condition_id'],
+    desc: 'On-chain resolution of one market ([] = the chain has not resolved it)',
+  });
+
+  addTool(cmd, 'settlements', {
+    tool: 'polymarket_settlements_bulk',
+    desc: 'On-chain resolutions of many markets, oldest resolution first',
+    options: [
+      FROM, TO,
+      ['--slug-prefix <p>', 'Only markets whose slug starts with this, e.g. btc-updown-5m-'],
+      CURSOR,
+      ['--limit <n>', 'Rows per page (default 100)'],
+    ],
+  });
+
+  addTool(cmd, 'archive', {
+    tool: 'polymarket_archive',
+    desc: 'Index of the Parquet L2 archive, or a 7-day download link for one file (--view url)',
+    options: [
+      ['--view <v>', 'datasets | url (default datasets)'],
+      ['--stream <s>', 'book_events | trades | l1_quotes (required for url)'],
+      ['--date <d>', 'url: the UTC day, YYYY-MM-DD'],
+      ['--date-from <d>', 'datasets: first UTC day, inclusive'],
+      ['--date-to <d>', 'datasets: last UTC day, inclusive'],
+      ['--asset <a>', 'Family files only, e.g. btc (with --tenor)'],
+      ['--tenor <t>', 'Family files only, e.g. 5m (with --asset)'],
+      ['--limit <n>', 'datasets: files per page (default 50)'],
+      ['--offset <n>', 'datasets: skip this many files'],
+    ],
+  });
+
+  addTool(cmd, 'leaderboard', {
+    tool: 'polymarket_leaderboard',
+    desc: 'Wallets ranked by realized P&L, hit rate, volume or trade count',
+    options: [
+      ['--category <c>', 'all | Crypto | Sports | Politics | Pop-Culture | Tech (default all)'],
+      ['--window <w>', '24h | 7d | 30d | all (default all)'],
+      ['--sort <s>', 'realized_pnl | realized_pnl_window | hit_rate | resolved | volume_all | trades_all | last_seen | markets | ...'],
+      ['--min-resolved <n>', 'Minimum resolved markets (default 20)'],
+      ['--min-volume-usd <usd>', 'Minimum lifetime volume in USD'],
+      ['--min-avg-usd <usd>', 'Minimum average trade in USD (20 drops bots)'],
+      ['--limit <n>', 'Rows per page (default 20, max 50)'],
+      ['--offset <n>', 'Rows to skip, 0-1000'],
+    ],
+  });
 }

package/src/commands/search.js

@@ -0,0 +1,10 @@
+import { addTool } from './tool-command.js';
+
+export function registerSearch(program) {
+  addTool(program, 'search <q>', {
+    tool: 'search',
+    args: ['q'],
+    desc: 'Search everything by name, symbol, address, ENS name or polymarket.com link: tokens, wallets and entities, HL traders, vaults, builders, Polymarket wallets and markets',
+    options: [['--limit <n>', 'Rows per section, 1-20 (default 5)']],
+  });
+}