@vike-io/cli 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes are documented here. Entries follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## 0.9.0 — `vike ohlcv` (CEX historical candles)
+
+- **`vike ohlcv <symbol>`** (new command, wraps the new `ohlcv` MCP tool). Historical CEX candles for a canonical ticker (`BTC`) or exchange pair (`BTCUSDT`) across any timeframe (1m–1w), spot or perp. Flags: `--interval`, `--exchange` (binance/bybit/okx/gate/kucoin/coinbase/mexc/pyth, or omit for the merged best-source series), `--market`, `--start`/`--end`, `--limit` (max 5000), and `--cursor` paging. Look-ahead-safe — the in-progress bucket is excluded. Distinct from `vike token chart`, which serves DEX candles by **contract address** at 5/30/120-min only.
+- **First live e2e test** (`tests/ohlcv.e2e.test.js`) hitting `vike.io/mcp`; `vitest.e2e.config.js` now auto-loads a gitignored `.env` for `VIKE_API_KEY` (real env vars still win). Coverage + `--help` tests updated.
+- New skill playbook `vike-ohlcv` (registered in `skills.sh.json`); routing/command maps updated across root `SKILL.md`, `vike-router`, `README`, and `AGENTS`. Eval questions added for historical-data fetch + an `ohlcv`-vs-`token chart` trap. Total: 41 skills (was 40), 36 MCP tools (was 35).
+
 ## 0.8.0 — HL share-card reverse-lookup + multi-IDE installer + SKILL.md hardening
 
 - **`vike perp find-position`** (new command, alias for the new `hl_position_match` MCP tool). Reverse-lookup a Hyperliquid open position from share-card details: paste `coin + side + leverage + entry` and get the wallet(s) holding a matching open position back. Walks widening entry tolerance bands (tight 0.05% → loose 0.5% → fallback 1.0%) with leverage tolerance ±0.5; tie-break by closest mark price. Returns `tolerance_used` so callers can flag low-confidence matches. Backed by `position_snapshots_latest` — near-real-time, no new schema.
@@ -43,22 +49,26 @@ Total: 38 skills (was 33), 34 MCP tools (was 29).
 Mostly internal-quality improvements; no new commands. Backbone for everything that follows.
 
 **New infra**
+
 - **Background update-check** — silent detached subprocess polls the registry once/day; next-run prints `Update available: X.Y.Z → A.B.C`. Honors `NO_UPDATE_NOTIFIER` / `CI` / `VIKE_NO_UPDATE_CHECK`.
 - **First-run-after-upgrade notice** — one-time `Updated to X.Y.Z` print.
 - **Telemetry skeleton** — anonymous UUID + 30-min session ID, fire-and-forget. NO sink endpoint wired yet (events drop silently); shape is stable so we can flip it on without refactoring. Opt-out via `DO_NOT_TRACK=1` or `VIKE_NO_TELEMETRY=1`.
 - **Centralized chain registry** (`src/chains.js`) — `ALL_CHAINS`, `EVM_CHAINS`, `WALLET_CHAINS`, `CHAIN_ALIASES`, `normaliseChain()`, `isEvmAddress()`.
 
 **Testing + release safety**
+
 - Two-tier vitest config — `npm test` (unit/integration, <30s) vs `npm run test:e2e` (live MCP, up to 2 min).
 - Four meta-tests added: shebang, pack-and-install (catches missing `files`), CLI help for every command, command coverage regression.
 - Pretest changeset validator — hard-fails on wrong package name in changeset frontmatter; warns on missing changeset.
 - Postinstall script hardened — global-install + TTY gates, always `exit 0`.
 
 **Skill quality evals (preview)**
+
 - `evals/` directory with a `uv run`-script harness: A/B-tests every question against `vike --help` only vs `vike --help + SKILL.md`. Scores per question; aggregates a Δ for each skill. If a skill doesn't move the score, it shouldn't ship. Run: `uv run --script evals/runner.py` (needs `ANTHROPIC_API_KEY`).
 - 14 starter questions in `evals/questions.yaml`.
 
 **Security**
+
 - `SECURITY.md` published (report at security@vike.io; 48h ack, 7d critical-fix SLA).
 - `CODEOWNERS` file (single-maintainer for now; security-sensitive paths called out).
 - Dependabot weekly PRs for npm + GitHub Actions deps.

package/README.md

@@ -41,6 +41,7 @@ Get an API key at [vike.io/account?tab=api-keys](https://vike.io/account?tab=api
 
 ```
 vike token   search | transfers | chart
+vike ohlcv   <symbol>          # CEX candles, any timeframe (BTC, BTCUSDT)
 vike wallet  summary | discover
 vike perp    funding | spreads | top-traders
 vike options flow

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "AI-agent CLI for vike.io on-chain analytics, perps, options, and prediction markets across 11 chains",
   "type": "module",
   "main": "src/index.js",

package/skills/vike/SKILL.md

@@ -66,7 +66,8 @@ X-API-KEY: vk_...
 |---|---|---|
 | Token by symbol/name → address, market cap, holders | **Tokens** | `vike token search` / `token_search` |
 | Token holders, who bought/sold, top inflows | **Tokens** | `vike token transfers` / `token_transfers` |
-| Token chart / OHLCV / historical price | **Tokens** | `vike token chart` / `token_chart` |
+| Token chart / DEX OHLCV by contract address | **Tokens** | `vike token chart` / `token_chart` |
+| CEX candles by ticker/pair, any timeframe (1m–1w), spot or perp | **Tokens** | `vike ohlcv <symbol>` / `ohlcv` |
 | Filter/screen tokens by smart-money flow, liquidity, age | **Tokens** | `vike token screener` / `token_screener` |
 | Single wallet's PnL, holdings, recent activity | **Wallets** | `vike wallet summary` / `wallet_summary` |
 | Top wallets by PnL on a token / leaderboard | **Wallets** | `vike wallet discover` / `wallet_discover` |
@@ -155,7 +156,8 @@ Address resolution, transfers, OHLCV, holder cohorts, screening.
 |---|---|---|
 | `token_search` | Symbol/name → contract address + chain + market cap | [vike-token-search](skills/vike-token-search/SKILL.md) |
 | `token_transfers` | Recent transfers with USD values; supports `--min-usd`, time windows | [vike-token-transfers](skills/vike-token-transfers/SKILL.md) |
-| `token_chart` | OHLCV from data_history (binance/bybit/okx/gate aggregate) | [vike-token-research](skills/vike-token-research/SKILL.md) |
+| `token_chart` | DEX OHLCV by contract address (5/30/120-min, data_history aggregate) | [vike-token-research](skills/vike-token-research/SKILL.md) |
+| `ohlcv` | CEX candles by ticker (BTC) or pair (BTCUSDT), 1m–1w, spot/perp, paged | [vike-ohlcv](skills/vike-ohlcv/SKILL.md) |
 | `token_holders` | Top holders + concentration metrics | [vike-token-holders](skills/vike-token-holders/SKILL.md) |
 | `token_screener` | Filter tokens by smart-money inflow, age, liquidity, sector | [vike-token-screener](skills/vike-token-screener/SKILL.md) |
 

package/skills/vike-ohlcv/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: vike-ohlcv
+description: Historical CEX candles for a canonical ticker (BTC) or exchange pair (BTCUSDT) at any timeframe (1m–1w), spot or perp. Use when the user asks "BTC hourly candles" / "ETH 4h chart on Binance" / "give me daily OHLCV for SOL" / needs look-ahead-safe candle data for a backtest.
+allowed-tools: Bash(vike:*)
+---
+
+# vike-ohlcv
+
+CEX OHLCV candles by ticker or pair. Distinct from `vike token chart`, which serves DEX candles by **contract address** at only 5/30/120-min resolution.
+
+## Command
+
+```bash
+vike ohlcv <symbol> [--interval 1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|1w] \
+                    [--exchange binance|bybit|okx|gate|kucoin|coinbase|mexc|pyth] \
+                    [--market spot|perp] [--start <ts>] [--end <ts>] \
+                    [--limit N] [--cursor <c>] [--json]
+```
+
+- `<symbol>` — canonical ticker (`BTC`, `ETH`) or an exchange pair (`BTCUSDT`, `BTCUSDT_PERP`).
+- `--exchange` — **omit for the merged best-source series** (best venue per minute, gaps backfilled). Pin a venue only for that venue's raw series.
+- `--interval` defaults to `1h`. `--market` defaults to `spot`.
+- `--start` / `--end` — ISO-8601 UTC (`2026-01-01`) or epoch ms. Buckets are left-aligned UTC.
+- `--limit` defaults to 500, hard max 5000.
+
+## Examples
+
+```bash
+# Last 500 hourly candles, merged best-source:
+vike ohlcv BTC --json
+
+# 4h Binance perp candles for ETH:
+vike ohlcv ETH --interval 4h --market perp --exchange binance --json
+
+# Daily candles over an explicit range:
+vike ohlcv SOL --interval 1d --start 2026-01-01 --end 2026-03-01 --json
+
+# Page forward with the cursor from a previous call:
+vike ohlcv BTC --interval 1m --limit 5000 --cursor <next_cursor> --json
+```
+
+## Output
+
+`{ symbol, pair, exchange, interval, market, tz, candles[], next_cursor }`
+
+Each candle: `{ ts (epoch ms, UTC), open, high, low, close, volume }`, ascending by `ts`.
+
+## Reading
+
+- **Look-ahead-safe**: the in-progress (partial) bucket is excluded, so the last candle is always closed — safe to feed into a backtest.
+- `exchange: "merged"` means no `--exchange` was pinned; each minute is sourced from the best available venue with gaps backfilled.
+- `pair` echoes how the symbol resolved — `BTCUSDT` for spot, `BTCUSDT_PERP` for perp.
+- Use `next_cursor` to page; pass it back via `--cursor`. A null/absent cursor means the series is exhausted.
+
+## Anti-patterns
+
+- Don't use this for an on-chain/DEX-only token with no CEX listing — use `vike token chart <contract_address>` instead.
+- Don't omit `--market perp` when the user clearly means a perpetual; spot and perp candles differ.
+- Don't request 1m candles over a multi-month range in one call — page with `--cursor` (hard max 5000 candles/call).
+
+## Pairs well with
+
+- `vike token chart <addr>` — DEX candles when there's no CEX pair
+- `vike perp funding` / `vike perp spreads` — pair candle context with funding/spread arb
+- `vike options flow` — overlay options positioning on the underlying's candles

package/skills/vike-router/SKILL.md

@@ -14,7 +14,8 @@ Route the user's question to the right `vike-*` skill.
 |---|---|
 | Token by symbol/name → address | `vike-token-search` |
 | Token holders / who bought / sold | `vike-token-transfers` |
-| Token price chart / OHLCV | `vike-token-research` |
+| Token price chart / DEX OHLCV by contract address | `vike-token-research` |
+| CEX candles by ticker/pair, any timeframe (BTC, BTCUSDT) | `vike-ohlcv` |
 | Generic token research (everything) | `vike-token-research` |
 | Single wallet's metrics | `vike-wallet-summary` |
 | Top wallets / leaderboard | `vike-wallet-discover` |
@@ -34,6 +35,7 @@ Route the user's question to the right `vike-*` skill.
 
 ```
 vike token   search | transfers | chart
+vike ohlcv   <symbol>          # CEX candles, any timeframe (BTC, BTCUSDT)
 vike wallet  summary | discover
 vike perp    funding | spreads | top-traders
 vike options flow

package/skills.sh.json

@@ -17,6 +17,7 @@
       "skills": [
         "vike-token-search",
         "vike-token-research",
+        "vike-ohlcv",
         "vike-token-transfers",
         "vike-token-holders",
         "vike-token-screener",

package/src/commands/ohlcv.js

@@ -0,0 +1,33 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerOhlcv(program) {
+  program
+    .command('ohlcv <symbol>')
+    .description('Historical CEX candles for a ticker (BTC) or pair (BTCUSDT) across any timeframe')
+    .option('--interval <i>', '1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 1w', '1h')
+    .option('--exchange <e>', 'Pin one venue: binance | bybit | okx | gate | kucoin | coinbase | mexc | pyth. Omit for merged best-source.')
+    .option('--market <m>', 'spot | perp', 'spot')
+    .option('--start <t>', 'ISO-8601 UTC or epoch ms (inclusive)')
+    .option('--end <t>', 'ISO-8601 UTC or epoch ms (exclusive)')
+    .option('--limit <n>', 'Max candles (default 500, max 5000)', '500')
+    .option('--cursor <c>', 'Opaque paging cursor from a previous call')
+    .option('--json', 'Emit JSON')
+    .action(async (symbol, opts) => {
+      try {
+        const args = {
+          symbol,
+          interval: opts.interval,
+          market: opts.market,
+          limit: parseInt10(opts.limit, 500),
+        };
+        if (opts.exchange !== undefined) args.exchange = opts.exchange;
+        if (opts.start !== undefined) args.start = opts.start;
+        if (opts.end !== undefined) args.end = opts.end;
+        if (opts.cursor !== undefined) args.cursor = opts.cursor;
+        const r = await callTool('ohlcv', args);
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/index.js

@@ -8,6 +8,7 @@ import { registerAlerts } from './commands/alerts.js';
 import { registerPolymarket } from './commands/polymarket.js';
 import { registerLabels } from './commands/labels.js';
 import { registerWeb } from './commands/web.js';
+import { registerOhlcv } from './commands/ohlcv.js';
 // Note: registerLabels also registers `vike funds` and `vike defi` top-level
 // commands. New wallet subcommands (counterparties, pnl-history, balances,
 // ens) are added under registerWallet.
@@ -67,6 +68,7 @@ registerAlerts(program);
 registerPolymarket(program);
 registerLabels(program);
 registerWeb(program);
+registerOhlcv(program);
 
 const _parseT0 = Date.now();
 program.parseAsync(process.argv)