@vike-io/cli 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.12.0
+
+### Minor Changes
+
+- 6a41844: Remove the commands and skills whose MCP tool the server no longer offers: `vike funds` (`fund_holdings`), `vike defi` (`defi_positions`), `vike ohlcv` (`ohlcv`), `vike token chart` (`token_chart`), `vike options flow` (`options_flow`) and `vike web search|fetch` (`web_search`, `web_fetch`), plus the `vike-fund-holdings`, `vike-defi-positions`, `vike-ohlcv`, `vike-options-flow`, `vike-web-search`, `vike-web-fetch` and `vike-web-research` skills and every cross-reference to them.
+  
+  Add `vike candles hl <symbol>` and `vike candles polymarket <token_id>` (the `hl_ohlcv` and `polymarket_ohlcv` tools) and the `vike-candles` skill.
+
+## 0.11.0
+
+### Minor Changes
+
+- 1082cc5: Add `vike-data` as a second command name, alongside `vike`.
+
+  `vike` collides with the Vike Trader multicall binary, which is also called
+  `vike` — two different programs, both ours, one name on PATH. Anyone running the
+  trading platform and this CLI on the same machine gets whichever the shell finds
+  first.
+
+  This is ADDITIVE: `vike` keeps working exactly as before, so nothing installed
+  today breaks. `vike-data` is the unambiguous name to move to, and the one the
+  docs should teach from here.
+
 All notable changes are documented here. Entries follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## 0.10.0 — commander 15 + Node 22.12 floor (drops Node 20)

package/README.md

@@ -1,13 +1,13 @@
 # @vike-io/cli
 
-> Repo + package: `@vike-io/cli` (npm) · `vike-io/vike-cli` (GitHub) · binary: `vike`
+> Repo + package: `@vike-io/cli` (npm) · `vike-io/vike-data-cli` (GitHub) · binary: `vike`
 
 [![npm version](https://img.shields.io/npm/v/@vike-io/cli.svg)](https://www.npmjs.com/package/@vike-io/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
-[![skills.sh](https://skills.sh/b/vike-io/vike-cli)](https://skills.sh/vike-io/vike-cli)
+[![skills.sh](https://skills.sh/b/vike-io/vike-data-cli)](https://skills.sh/vike-io/vike-data-cli)
 
-> **Command-line interface for the [vike.io](https://vike.io) API.** On-chain analytics, perpetuals, options flow, and prediction-market data across 11 chains — designed to be driven by AI agents (Claude Code, OpenClaw) as well as humans.
+> **Command-line interface for the [vike.io](https://vike.io) API.** On-chain analytics, perpetuals, and prediction-market data across 11 chains — designed to be driven by AI agents (Claude Code, OpenClaw) as well as humans.
 
 ## Install
 
@@ -17,7 +17,7 @@ npm install -g @vike-io/cli
 
 # OR install just the skill playbooks into your AI agent (Claude Code, Cursor,
 # Codex, Copilot, OpenCode and 50+ more — auto-detected):
-npx skills add vike-io/vike-cli
+npx skills add vike-io/vike-data-cli
 ```
 
 After `npm install`, you can also drop the skill into AI agents from the CLI itself:
@@ -40,11 +40,10 @@ Get an API key at [vike.io/account?tab=api-keys](https://vike.io/account?tab=api
 ## Commands at a glance
 
 ```
-vike token   search | transfers | chart
-vike ohlcv   <symbol>          # CEX candles, any timeframe (BTC, BTCUSDT)
+vike token   search | transfers | screener | holders
 vike wallet  summary | discover
 vike perp    funding | spreads | top-traders
-vike options flow
+vike candles hl <symbol> | polymarket <token_id>
 vike alerts  list | channels | create | edit | delete
 vike init | doctor | schema | whoami | login | logout
 ```
@@ -55,24 +54,24 @@ Run `vike schema --pretty` for the full command + flag reference.
 
 | Domain | What you can ask |
 |---|---|
-| **Tokens** | Resolve symbols → addresses, see top buyers/sellers, pull OHLCV |
+| **Tokens** | Resolve symbols → addresses, see top buyers/sellers, screen by smart-money flow |
 | **Wallets** | Aggregate metrics per wallet, leaderboards by volume / PnL / netflow |
 | **Perps** | Funding rates + cross-venue spreads across Binance / Bybit / OKX / Aster / Hyperliquid |
 | **Hyperliquid** | Top-trader leaderboard with PnL / ROI / win-rate filters |
-| **Options** | Deribit flow for BTC / ETH / SOL with put-call ratios |
+| **Candles** | Historical OHLCV for Hyperliquid perp/spot markets and Polymarket outcome tokens |
 | **Alerts** | Create transfer alerts; deliver to email or Discord |
 
 ## For AI agents
 
-This package ships **41 skill playbooks** under [`skills/`](skills/) — markdown files designed to be loaded by AI coding agents (Claude Code, Cursor, Codex, Copilot, OpenCode, …) so they know when and how to invoke each command. They are grouped in [`skills.sh.json`](skills.sh.json) by domain (Tokens / Wallets / CEX perps / Hyperliquid / Options / Polymarket / Alerts / Web research).
+This package ships **36 skill playbooks** under [`skills/`](skills/) — markdown files designed to be loaded by AI coding agents (Claude Code, Cursor, Codex, Copilot, OpenCode, …) so they know when and how to invoke each command. They are grouped in [`skills.sh.json`](skills.sh.json) by domain (Tokens / Wallets / CEX perps / Hyperliquid / Candles / Polymarket / Alerts).
 
 Three install paths, pick whichever fits your stack:
 
 ```bash
 # 1. Install just the skill files for your agent (no Node binary needed):
-npx skills add vike-io/vike-cli                # auto-detects the agent
-npx skills add vike-io/vike-cli -a claude-code # explicit target
-npx skills add vike-io/vike-cli --list          # list all 41 first
+npx skills add vike-io/vike-data-cli                # auto-detects the agent
+npx skills add vike-io/vike-data-cli -a claude-code # explicit target
+npx skills add vike-io/vike-data-cli --list          # list all 41 first
 
 # 2. Use the CLI itself to install the umbrella skill into multiple agents:
 vike install --claude --cursor --copilot --agents
@@ -117,5 +116,5 @@ MIT — see [LICENSE](LICENSE).
 ## Links
 
 - Homepage: [vike.io](https://vike.io)
-- Issues: [github.com/vike-io/vike-cli/issues](https://github.com/vike-io/vike-cli/issues)
+- Issues: [github.com/vike-io/vike-data-cli/issues](https://github.com/vike-io/vike-data-cli/issues)
 - API docs: [vike.io/api](https://vike.io/api)

package/package.json

@@ -3,12 +3,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.10.0",
+  "version": "0.12.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",
   "bin": {
-    "vike": "./src/index.js"
+    "vike": "./src/index.js",
+    "vike-data": "./src/index.js"
   },
   "files": [
     "src/**/*.js",
@@ -56,10 +57,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vike-io/vike-cli.git"
+    "url": "git+https://github.com/vike-io/vike-data-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/vike-io/vike-cli/issues"
+    "url": "https://github.com/vike-io/vike-data-cli/issues"
   },
   "homepage": "https://vike.io",
   "engines": {
@@ -69,8 +70,8 @@
     "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.27.9",
+    "@changesets/cli": "^3.0.3",
     "eslint": "^10.4.0",
-    "vitest": "^4.1.7"
+    "vitest": "^5.0.4"
   }
 }

package/skills/vike/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: vike
-description: "Use this skill whenever the user asks any question about on-chain crypto data, wallet behavior, token transfers, smart money, CEX perpetual futures, Hyperliquid perps, Deribit options, prediction markets (Polymarket), DeFi positions, ENS, or institutional fund holdings — and live data from vike.io would improve the answer. This includes questions like \"who is buying X token\", \"what is wallet 0x... doing\", \"top wallets by PnL\", \"funding rate spread across Binance/Bybit/OKX\", \"largest HL perp traders this week\", \"Deribit BTC put-call ratio\", \"who is winning on Polymarket\", \"which funds hold X token\", \"resolve this ENS\", \"label this wallet\", \"trace this transfer\", \"top tokens by smart-money inflow\". Always use this skill proactively when the user's query could benefit from real-time or historical on-chain data — don't wait for the user to explicitly ask to \"use vike\". If the user asks a general on-chain question that requires synthesis across wallets/tokens/venues, route to vike first."
+description: "Use this skill whenever the user asks any question about on-chain crypto data, wallet behavior, token transfers, smart money, CEX perpetual futures, Hyperliquid perps, prediction markets (Polymarket), ENS, or on-chain flows — and live data from vike.io would improve the answer. This includes questions like \"who is buying X token\", \"what is wallet 0x... doing\", \"top wallets by PnL\", \"funding rate spread across Binance/Bybit/OKX\", \"largest HL perp traders this week\", \"who is winning on Polymarket\", \"resolve this ENS\", \"label this wallet\", \"trace this transfer\", \"top tokens by smart-money inflow\". Always use this skill proactively when the user's query could benefit from real-time or historical on-chain data — don't wait for the user to explicitly ask to \"use vike\". If the user asks a general on-chain question that requires synthesis across wallets/tokens/venues, route to vike first."
 ---
 
 # vike — Multi-chain On-chain Analytics
 
-Answer on-chain questions using the vike.io platform: 11 chains (ETH, BSC, Base, Arbitrum, HyperEVM, BTC, Solana, Tron, XMR, ZEC, Dash), full Hyperliquid perps coverage, CEX perps across 5 venues, Deribit options, Polymarket prediction markets, multi-source wallet labels, and a 34-tool MCP server.
+Answer on-chain questions using the vike.io platform: 11 chains (ETH, BSC, Base, Arbitrum, HyperEVM, BTC, Solana, Tron, XMR, ZEC, Dash), full Hyperliquid perps coverage, CEX perps across 5 venues, Polymarket prediction markets, multi-source wallet labels, and a 34-tool MCP server.
 
 **MCP endpoint for all calls:** `https://vike.io/mcp` (JSON-RPC 2.0)
 **Or use the CLI:** `npm install -g @vike-io/cli` → `vike <command>`
@@ -66,8 +66,6 @@ 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 / 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` |
@@ -80,32 +78,28 @@ X-API-KEY: vk_...
 | ENS name → address or address → ENS | **Wallets** | `vike wallet ens` / `wallet_ens` |
 | Bulk-label many wallets at once | **Wallets** | `vike wallet batch` / `wallet_batch_labels` |
 | Why is this wallet labeled X? (provenance) | **Labels** | `vike labels provenance` / `wallet_label_provenance` |
-| Which funds hold this token / what funds hold | **Funds** | `vike funds holdings` / `fund_holdings` |
 | Funding rates across CEX perps (Binance/Bybit/OKX/Aster/HL) | **CEX Perps** | `vike perp funding` / `perp_funding` |
 | Price spreads of same symbol across CEX perp venues | **CEX Perps** | `vike perp spreads` / `perp_spreads` |
 | Top Hyperliquid perp traders by PnL / volume | **HL Perps** | `vike perp top-traders` / `hl_perp_top_traders` |
 | Reverse-lookup an HL share card → which wallet holds it | **HL Perps** | `vike perp find-position` / `hl_position_match` |
-| Deribit options flow, put/call ratios, IV | **Options** | `vike options flow` / `options_flow` |
+| Historical candles for a Hyperliquid perp or spot market (1m–1d) | **Candles** | `vike candles hl <symbol>` / `hl_ohlcv` |
+| Historical probability candles for a Polymarket outcome token | **Candles** | `vike candles polymarket <token_id>` / `polymarket_ohlcv` |
 | Active Polymarket markets, volume, odds | **Polymarket** | `vike polymarket markets` / `polymarket_markets` |
 | Single Polymarket market detail | **Polymarket** | `vike polymarket detail` / `polymarket_market_detail` |
 | Polymarket trader profile / positions | **Polymarket** | `vike polymarket wallet` / `polymarket_wallet` |
 | Best-performing Polymarket traders | **Polymarket** | `vike polymarket smart-money` / `polymarket_smart_money` |
-| DeFi positions for a wallet (Aave/Uniswap/Lido/…) | **DeFi** | `vike defi positions` / `defi_positions` |
 | Create / list / edit price-or-flow alerts | **Alerts** | `vike alerts ...` / `alerts_*` |
-| General web search or fetch + AI summarize a URL | **Web** | `vike web search` / `web_search`, `vike web fetch` / `web_fetch` |
 
 **When in doubt, start with `vike token search` or `vike wallet summary`** — both are cheap, return instantly, and disambiguate what the user actually meant.
 
 ### Example query routing
 ```
 "Top 20 wallets buying PEPE in the last 24h"          → wallet_discover         (token=PEPE, sort=net_inflow_usd)
-"What is 0xd8dA6BF...AbA96 holding?"                  → wallet_summary           + defi_positions
+"What is 0xd8dA6BF...AbA96 holding?"                  → wallet_summary           + wallet_token_balances
 "Funding rate for BTC across all perp venues"         → perp_funding             (symbol=BTC)
 "Cheapest venue to short ETH right now?"              → perp_spreads             (symbol=ETH)
 "Biggest HL perp PnL last week"                       → hl_perp_top_traders      (window=7d, sort=pnl_usd)
-"Largest BTC put writes on Deribit today"             → options_flow             (asset=BTC, side=put)
 "Show me the largest Polymarket bets on US election"  → polymarket_market_detail + polymarket_smart_money
-"Which funds bought Lido tokens this quarter?"        → fund_holdings            (token=LDO, window=90d)
 "Why is 0x28C6... labeled 'Binance hot wallet'?"      → wallet_label_provenance  (addr=0x28C6...)
 "Resolve vitalik.eth"                                 → wallet_ens               (name=vitalik.eth)
 "Alert me when whale 0xABCD sells over $1M of WBTC"   → alerts_create
@@ -150,14 +144,12 @@ Run `vike schema --pretty` (or call MCP `tools/list`) to see the live arg shape
 For deeper per-tool workflows (multi-step recipes, common pitfalls, output schemas), see the `skills/` directory in this repo. The router lives at [`skills/vike-router/SKILL.md`](skills/vike-router/SKILL.md).
 
 ### Tokens
-Address resolution, transfers, OHLCV, holder cohorts, screening.
+Address resolution, transfers, holder cohorts, screening.
 
 | Tool | Description | Skill |
 |---|---|---|
 | `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` | 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) |
 
@@ -185,13 +177,12 @@ Profile, PnL, transactions, comparison, tracing, counterparty graph.
 
 ---
 
-### Labels & Funds
-Institutional wallet identification + label provenance.
+### Labels
+Wallet label provenance.
 
 | Tool | Description | Skill |
 |---|---|---|
 | `wallet_label_provenance` | Why a wallet got a given label (sources + confidence) | [vike-wallet-label-provenance](skills/vike-wallet-label-provenance/SKILL.md) |
-| `fund_holdings` | Which funds/institutions hold a given token + recent flows | [vike-fund-holdings](skills/vike-fund-holdings/SKILL.md) |
 
 Vike's label cascade is multi-source — when an answer hinges on "is this really a CEX hot wallet?", call `wallet_label_provenance` rather than trusting a single source.
 
@@ -219,14 +210,13 @@ For per-symbol HL screening / individual trader deep-dive, use [vike-perp-screen
 
 ---
 
-### Options
-Deribit options chain + flow.
+### Candles
+Historical OHLCV from venues whose data is on-chain.
 
 | Tool | Description | Skill |
 |---|---|---|
-| `options_flow` | Recent large trades, put/call ratios, IV by strike/expiry | [vike-options-flow](skills/vike-options-flow/SKILL.md) |
-
-Coverage: BTC + ETH on Deribit. Other venues not currently supported.
+| `hl_ohlcv` | Hyperliquid perp or spot candles, 1m–1d, built from HL's own executed fills (also HIP-3 builder DEXs) | [vike-candles](skills/vike-candles/SKILL.md) |
+| `polymarket_ohlcv` | Candles for ONE Polymarket outcome token (price = probability, 0–1); needs `token_id`, not a condition_id | [vike-candles](skills/vike-candles/SKILL.md) |
 
 ---
 
@@ -242,17 +232,6 @@ Prediction markets — markets, traders, smart-money.
 
 ---
 
-### DeFi
-Cross-protocol positions for a wallet.
-
-| Tool | Description | Skill |
-|---|---|---|
-| `defi_positions` | Aave/Uniswap V2+V3/Lido/Compound/etc. open positions per wallet | [vike-defi-positions](skills/vike-defi-positions/SKILL.md) |
-
-Covers ~30+ protocols across ETH/BSC/Base/Arbitrum.
-
----
-
 ### Alerts
 Create + manage alerts; deliver to email, Telegram, Discord, Webhook.
 
@@ -267,18 +246,6 @@ Create + manage alerts; deliver to email, Telegram, Discord, Webhook.
 
 Alerts fire on a 2-minute cron cycle (not streaming). Don't recommend WebSocket / push streaming — it's not how the platform works.
 
----
-
-### Web
-General web search + AI-summarized fetch for off-chain context (news, docs, social).
-
-| Tool | Description | Skill |
-|---|---|---|
-| `web_search` | Tavily-primary + Serper fallback web search | [vike-web-search](skills/vike-web-search/SKILL.md) |
-| `web_fetch` | Fetch a URL + AI Q&A over its contents (Cerebras-backed) | [vike-web-fetch](skills/vike-web-fetch/SKILL.md), [vike-web-research](skills/vike-web-research/SKILL.md) |
-
----
-
 ## Historical data availability
 
 Coverage windows per dataset. Don't ask for data older than the window — the tool will return empty or 503.
@@ -296,19 +263,6 @@ Coverage windows per dataset. Don't ask for data older than the window — the t
 | Solana | 2026-Q1 onward | Recent only — see `vike-cli` chain-coverage notes |
 | Tron/XMR/ZEC/Dash | 2024 onward | Recent only |
 
-### Prices (data_history, spot)
-
-| Venue | Earliest | Notes |
-|---|---|---|
-| Binance | 2017-08 | Full minute-level OHLCV |
-| Bybit | 2020-03 | Full minute-level OHLCV |
-| OKX | 2019-04 | Full minute-level OHLCV |
-| Gate | 2017 (CSV) → 2024-05 (CSV ends) | After 2024-05 use API; capped 10k minutes/request |
-| Coinbase | 2015 | Full history (recently added) |
-| KuCoin | 2018 | Full history (recently added) |
-| Pyth | 2023 | On-chain price feed; sparse pre-2023 |
-| Deribit options | 2020 onward | BTC + ETH only |
-
 ### Hyperliquid perps (hl_perps DB)
 
 | Dataset | Window | Notes |

package/skills/vike-candles/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: vike-candles
+description: Historical OHLCV candles for a Hyperliquid perp or spot market, or for one Polymarket outcome token. Use when the user asks for a price chart, candles, OHLCV, or price history of a Hyperliquid asset or a Polymarket outcome (its probability over time).
+allowed-tools: Bash(vike:*)
+---
+
+# vike-candles
+
+Two candle sources, both from venues whose data is on-chain. There is **no** candle source for
+CEX tickers (BTCUSDT on Binance and the like) or for an arbitrary ERC-20 contract address; say so
+rather than guessing a venue.
+
+## Command
+
+Hyperliquid (perp or spot), built from HL's own executed fills:
+
+```bash
+vike candles hl <symbol>
+  [--interval 1m|5m|15m|30m|1h|4h|1d]   # default 1h
+  [--market perp|spot]                  # default perp
+  [--dex <name>]                        # HIP-3 builder DEX; default HL (the core venue)
+  [--start <iso|epoch-ms>] [--end <iso|epoch-ms>]   # half-open [start, end)
+  [--limit N]                           # default 500, max 5000
+  [--json]
+```
+
+Polymarket, ONE outcome token (a probability, 0-1):
+
+```bash
+vike candles polymarket <token_id>
+  [--interval 1m|5m|1h|1d]              # default 1h
+  [--from <epoch-ms>] [--to <epoch-ms>] # both inclusive
+  [--limit N]                           # default 500, max 1000
+  [--json]
+```
+
+## Common queries
+
+| Question | Command |
+|---|---|
+| "Hourly BTC perp candles, last week" | `vike candles hl BTC --interval 1h --limit 168` |
+| "HYPE spot daily candles" | `vike candles hl HYPE --market spot --interval 1d` |
+| "4h ETH, 200 bars" | `vike candles hl ETH --interval 4h --limit 200` |
+| "Price history of the YES outcome of market X" | get `clob_token_ids` from `vike polymarket market <condition_id>`, then `vike candles polymarket <token_id> --interval 1h` |
+
+## Output
+
+HL: `ts` (epoch ms, UTC), `open`, `high`, `low`, `close`, `volume`, `volume_usd`, `n_trades`, ascending by `ts`, plus `source`.
+Polymarket: `ts`, `open`, `high`, `low`, `close`, `volume`, `trades`, oldest first.
+
+## Pitfalls
+
+- Polymarket takes an **outcome token id**, not a `condition_id`. A condition id returns nothing useful; read the token ids off `clob_token_ids` in `vike polymarket market`.
+- Polymarket has no cursor: a window wider than `--limit` is truncated at the **old** end. Raise `--from` to reach the recent end.
+- Polymarket `--from` / `--to` are epoch **milliseconds**; HL `--start` / `--end` also accept ISO-8601.
+- HL buckets are left-aligned UTC and the window is half-open.
+
+## Pairs well with
+
+- `vike polymarket market <condition_id>` — to find the token ids
+- `vike perp top-traders` — who is trading the asset behind the candles

package/skills/vike-perp-screener/SKILL.md

@@ -45,5 +45,4 @@ wait
 
 ## Pairs well with
 
-- `vike-options-flow` for the corresponding options positioning on BTC/ETH/SOL
 - `vike-perp-funding-arb` for the funding-only deep dive

package/skills/vike-router/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vike-router
-description: Entry point — decide which vike skill to use. Read this first when the user asks anything about on-chain analytics, perps, options, prediction markets, wallets, or tokens.
+description: Entry point — decide which vike skill to use. Read this first when the user asks anything about on-chain analytics, perps, prediction markets, wallets, or tokens.
 allowed-tools: Bash(vike:*)
 ---
 
@@ -15,7 +15,6 @@ 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 / 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` |
@@ -27,18 +26,17 @@ Route the user's question to the right `vike-*` skill.
 | Profile a single HL perp trader | `vike-hl-trader-profile` |
 | HL market overview (vol/OI/funding) | `vike-perp-screener` |
 | Compare a symbol across all perp venues | `vike-cross-venue-perps` |
-| Deribit options flow / put-call ratios | `vike-options-flow` |
+| Historical candles (Hyperliquid perp/spot, Polymarket outcome token) | `vike-candles` |
 | Create / list / edit alerts | `vike-alerts-setup` |
 | Auth / setup / "I just installed it" | `vike-core` |
 
 ## Quick command map
 
 ```
-vike token   search | transfers | chart
-vike ohlcv   <symbol>          # CEX candles, any timeframe (BTC, BTCUSDT)
+vike token   search | transfers | screener | holders
 vike wallet  summary | discover
 vike perp    funding | spreads | top-traders
-vike options flow
+vike candles hl <symbol> | polymarket <token_id>
 vike alerts  list | channels | create | edit | delete
 vike init | doctor | schema | whoami | login | logout
 ```

package/skills/vike-token-research/SKILL.md

@@ -22,11 +22,6 @@ Multi-call token research workflow.
    vike token transfers <addr> --tab sold   --period 24h --chain <chain> --json
    ```
 
-3. **Price action**
-   ```bash
-   vike token chart <addr> --interval 30 --json
-   ```
-
 ## Verdict heuristics
 
 After step 2, classify direction-of-pressure:

package/skills/vike-token-search/SKILL.md

@@ -36,5 +36,4 @@ vike token search PEPE --chain ethereum --limit 5
 ## Pairs well with
 
 - `vike token transfers <address>` after resolution
-- `vike token chart <address>`
 - `vike-token-research` for a full multi-call report

package/skills/vike-token-transfers/SKILL.md

@@ -40,4 +40,3 @@ Each row is one wallet: `address`, `qty`, `usd_value`, `label` (if known), `tx_c
 ## Pairs well with
 
 - `vike wallet summary <addr>` to profile any interesting buyer/seller
-- `vike token chart <addr>` to correlate flows with price action

package/skills/vike-wallet-balances/SKILL.md

@@ -49,12 +49,10 @@ Holdings sorted by `usd_value` descending.
 ## Anti-patterns
 
 - This is ERC-20 only — does NOT include native ETH/BNB/MATIC (would need separate calls; not in our current tool surface). Mention this when reporting "total holdings".
-- Don't combine with `defi_positions` totals naively — there's overlap (e.g. aUSDC shows in `balances`, the Aave deposit shows in `defi_positions`; you'd double-count).
 - For wallets with 100+ tokens, the response is large — use `--min-usd 100` or higher to focus on meaningful holdings.
 
 ## Pairs well with
 
-- `vike defi <addr>` — protocol positions (Aave/Uniswap LP/Lido) alongside spot balances
 - `vike wallet pnl-history <addr>` — how the wallet got to its current state
 - `vike labels <addr>` — institutional context
 - `vike wallet ens <addr>` — friendly identifier

package/skills/vike-wallet-batch/SKILL.md

@@ -53,4 +53,3 @@ One row per INPUT address (preserves input order — useful when joining back to
 
 - `vike labels <addr>` — drill into any address showing high-confidence labels
 - `vike wallet compare <a> <b>` — pick two interesting batch results and diff them
-- `vike funds` — when batch reveals fund/MM/treasury wallets, get their flows

package/skills/vike-wallet-ens/SKILL.md

@@ -38,4 +38,3 @@ vike wallet ens 0x28c6c06298d514db089934071355e5743bf21d60
 
 - `vike labels <addr>` — combine ENS + labels for the fullest identity view
 - `vike wallet summary <addr>` — ENS + activity profile
-- `vike funds` — pair with ENS lookups on the top entries for richer display

package/skills/vike-wallet-label-provenance/SKILL.md

@@ -61,5 +61,3 @@ vike labels 0x28C6c06298d514Db089934071355E5743bf21d60     # Binance Hot Wallet
 ## Pairs well with
 
 - `vike wallet summary <addr>` — for the flow metrics of the labeled wallet
-- `vike funds` — find all known fund wallets and their recent flows
-- `vike defi <addr>` — see what protocols this entity is using

package/skills/vike-wallet-pnl-history/SKILL.md

@@ -55,4 +55,3 @@ For lifetime realized PnL: `vike wallet discover --sort pnl --window all`.
 
 - `vike wallet summary <addr>` for the aggregate context
 - `vike wallet counterparties <addr>` to see WHO they traded with
-- `vike token chart <addr>` to correlate flow spikes with price action

package/skills/vike-wallet-portfolio/SKILL.md

@@ -17,7 +17,6 @@ vike wallet ens     $ADDR --json &     # cheap, ~1 credit
 vike labels         $ADDR --json &     # cheap, ~1 credit
 vike wallet summary $ADDR --json &     # cheap, ~2 credits
 vike wallet balances $ADDR --json &    # multi-chain, ~3 credits
-vike defi           $ADDR --json &     # multi-chain, ~3 credits
 vike wallet pnl-history $ADDR --days 30 --json &
 wait
 ```
@@ -47,14 +46,13 @@ wait
 
 ## Cost
 
-~6 parallel calls, ~12 credits total. Use sparingly — only when the user wants the FULL picture, not a single dimension.
+~5 parallel calls, ~9 credits total. Use sparingly — only when the user wants the FULL picture, not a single dimension.
 
 ## When to use a focused skill instead
 
 - "Just labels for X" → `vike-wallet-label-provenance`
 - "What does X hold" → `vike-wallet-balances`
 - "Top counterparties of X" → `vike-wallet-counterparties`
-- "DeFi positions of X" → `vike-defi-positions`
 
 ## Pairs well with
 

package/skills.sh.json

@@ -13,11 +13,10 @@
     },
     {
       "title": "Tokens",
-      "description": "Resolve, screen, and research tokens across 11 chains. Smart-money inflow, holders, recent transfers, OHLCV.",
+      "description": "Resolve, screen, and research tokens across 11 chains. Smart-money inflow, holders, recent transfers.",
       "skills": [
         "vike-token-search",
         "vike-token-research",
-        "vike-ohlcv",
         "vike-token-transfers",
         "vike-token-holders",
         "vike-token-screener",
@@ -26,7 +25,7 @@
     },
     {
       "title": "Wallets",
-      "description": "Per-wallet profile, PnL, counterparty graphs, ENS, batch labelling, fund affiliation, DeFi positions.",
+      "description": "Per-wallet profile, PnL, counterparty graphs, ENS, batch labelling, label provenance.",
       "skills": [
         "vike-wallet-summary",
         "vike-wallet-portfolio",
@@ -39,9 +38,7 @@
         "vike-wallet-pnl-history",
         "vike-wallet-balances",
         "vike-wallet-ens",
-        "vike-wallet-label-provenance",
-        "vike-fund-holdings",
-        "vike-defi-positions"
+        "vike-wallet-label-provenance"
       ]
     },
     {
@@ -64,10 +61,10 @@
       ]
     },
     {
-      "title": "Options",
-      "description": "Deribit BTC/ETH options flow + put-call ratios.",
+      "title": "Candles",
+      "description": "Historical OHLCV for Hyperliquid perp/spot markets and Polymarket outcome tokens.",
       "skills": [
-        "vike-options-flow"
+        "vike-candles"
       ]
     },
     {
@@ -88,15 +85,6 @@
         "vike-alerts-setup",
         "vike-alerts-webhook"
       ]
-    },
-    {
-      "title": "Web research",
-      "description": "Off-chain context: general web search and AI-summarized URL fetch for news, docs, and social.",
-      "skills": [
-        "vike-web-search",
-        "vike-web-fetch",
-        "vike-web-research"
-      ]
     }
   ]
 }

package/src/commands/candles.js

@@ -0,0 +1,57 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerCandles(program) {
+  const cmd = program
+    .command('candles')
+    .description('Historical OHLCV candles — Hyperliquid markets and Polymarket outcome tokens');
+
+  cmd
+    .command('hl <symbol>')
+    .description('Hyperliquid candles (perp or spot), aggregated from HL executed fills')
+    .option('--interval <i>', '1m | 5m | 15m | 30m | 1h | 4h | 1d', '1h')
+    .option('--market <m>', 'perp | spot', 'perp')
+    .option('--dex <d>', 'Perp DEX (default HL, the core venue; others are HIP-3 builder DEXs)')
+    .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('--json', 'Emit JSON')
+    .action(async (symbol, opts) => {
+      try {
+        const args = {
+          symbol,
+          interval: opts.interval,
+          market: opts.market,
+          limit: parseInt10(opts.limit, 500),
+        };
+        if (opts.dex !== undefined) args.dex = opts.dex;
+        if (opts.start !== undefined) args.start = opts.start;
+        if (opts.end !== undefined) args.end = opts.end;
+        const r = await callTool('hl_ohlcv', args);
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('polymarket <token_id>')
+    .description('Candles for ONE Polymarket outcome token (prices are probabilities, 0-1)')
+    .option('--interval <i>', '1m | 5m | 1h | 1d', '1h')
+    .option('--from <ms>', 'Epoch milliseconds, inclusive lower bound')
+    .option('--to <ms>', 'Epoch milliseconds, inclusive upper bound')
+    .option('--limit <n>', 'Max candles (default 500, max 1000)', '500')
+    .option('--json', 'Emit JSON')
+    .action(async (tokenId, opts) => {
+      try {
+        const args = {
+          token_id: tokenId,
+          interval: opts.interval,
+          limit: parseInt10(opts.limit, 500),
+        };
+        if (opts.from !== undefined) args.from = opts.from;
+        if (opts.to !== undefined) args.to = opts.to;
+        const r = await callTool('polymarket_ohlcv', args);
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/labels.js

@@ -1,6 +1,5 @@
 import { callTool } from '../mcp-client.js';
 import { emit, emitError } from '../format.js';
-import { parseInt10 } from '../util.js';
 
 export function registerLabels(program) {
   // `vike labels <address>` — multi-source label provenance for one wallet
@@ -14,35 +13,4 @@ export function registerLabels(program) {
         emit(r, opts);
       } catch (err) { emitError(err, opts); }
     });
-
-  // `vike funds` — top labeled funds / MM / treasury / CEX by recent net inflow
-  program
-    .command('funds')
-    .description('Top labeled fund / market-maker / treasury / CEX wallets by net inflow')
-    .option('--kind <k>', 'funds | cex | mm | treasury', 'funds')
-    .option('--window <w>', '7d | 30d | 90d | 180d | all', '30d')
-    .option('--limit <n>', 'Max wallets (max 25)', '10')
-    .option('--json', 'Emit JSON')
-    .action(async (opts) => {
-      try {
-        const r = await callTool('fund_holdings', {
-          kind: opts.kind,
-          window: opts.window,
-          limit: parseInt10(opts.limit, 10),
-        });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
-
-  // `vike defi <address>` — DeBank protocol positions for a wallet
-  program
-    .command('defi <address>')
-    .description('DeFi protocol positions for a wallet across all DeBank-supported chains')
-    .option('--json', 'Emit JSON')
-    .action(async (address, opts) => {
-      try {
-        const r = await callTool('defi_positions', { address });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
 }

package/src/commands/token.js

@@ -5,7 +5,7 @@ import { parseInt10 } from '../util.js';
 export function registerToken(program) {
   const cmd = program
     .command('token')
-    .description('Token search, transfers, and price charts');
+    .description('Token search, transfers, screener and holders');
 
   cmd
     .command('search <query>')
@@ -43,21 +43,6 @@ export function registerToken(program) {
       } catch (err) { emitError(err, opts); }
     });
 
-  cmd
-    .command('chart <token_address>')
-    .description('OHLCV candle data for a token')
-    .option('--interval <m>', '5 | 30 | 120 minutes', '30')
-    .option('--json', 'Emit JSON')
-    .action(async (tokenAddress, opts) => {
-      try {
-        const r = await callTool('token_chart', {
-          token_address: tokenAddress,
-          interval: opts.interval,
-        });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
-
   cmd
     .command('screener')
     .description('Token discovery filter — rank tokens by volume / inflow / holders / smart-money inflow')

package/src/index.js

@@ -3,15 +3,12 @@ import { Command } from 'commander';
 import { registerToken } from './commands/token.js';
 import { registerWallet } from './commands/wallet.js';
 import { registerPerp } from './commands/perp.js';
-import { registerOptions } from './commands/options.js';
 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.
+import { registerCandles } from './commands/candles.js';
+// New wallet subcommands (counterparties, pnl-history, balances, ens) are
+// added under registerWallet.
 import { registerInit } from './commands/init.js';
 import { registerInstall } from './commands/install.js';
 import { registerDoctor } from './commands/doctor.js';
@@ -63,12 +60,10 @@ registerSchema(program);
 registerToken(program);
 registerWallet(program);
 registerPerp(program);
-registerOptions(program);
 registerAlerts(program);
 registerPolymarket(program);
 registerLabels(program);
-registerWeb(program);
-registerOhlcv(program);
+registerCandles(program);
 
 const _parseT0 = Date.now();
 program.parseAsync(process.argv)

package/skills/vike-defi-positions/SKILL.md

@@ -1,59 +0,0 @@
----
-name: vike-defi-positions
-description: DeFi protocol positions for a wallet across all DeBank-supported chains (Aave, Uniswap LP, Curve, Pendle, EigenLayer, etc.) — net USD, asset USD, debt USD per protocol. Use when the user asks "what DeFi positions does this wallet have" / "is wallet X farming yields" / "show me the protocol breakdown for Y".
-allowed-tools: Bash(vike:*)
----
-
-# vike-defi-positions
-
-## Command
-
-```bash
-vike defi <address> [--json]
-```
-
-## Example
-
-```bash
-vike defi 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045   # vitalik.eth
-```
-
-## Output shape
-
-```json
-{
-  "address": "0x...",
-  "total_balance": {
-    "total_usd": 12345.67,
-    "chains": [
-      { "chain": "eth",    "usd": 9000.00 },
-      { "chain": "arb",    "usd": 2000.00 },
-      { "chain": "base",   "usd": 1345.67 }
-    ]
-  },
-  "protocols": [
-    { "protocol": "Aave V3",      "chain": "eth",  "net_usd": 5000.00, "asset_usd": 8000.00, "debt_usd": 3000.00, "positions": 2 },
-    { "protocol": "Uniswap V3",   "chain": "eth",  "net_usd": 2500.00, "asset_usd": 2500.00, "debt_usd": 0.00,    "positions": 4 },
-    ...
-  ]
-}
-```
-
-## Reading
-
-- `net_usd = asset_usd - debt_usd` — what the position is actually worth
-- A protocol row with `debt_usd > 0` means the wallet is **borrowing** (Aave / Compound / Morpho). High debt + low asset = leveraged.
-- `positions` count tells you how many active positions inside one protocol (e.g. 4 Uniswap LP positions)
-- `total_balance.total_usd` includes both DeFi positions AND wallet token balances; the `protocols` array is DeFi-only
-
-## Anti-patterns
-
-- DeBank may not cover every L2/protocol — a missing protocol doesn't mean the wallet has no position there
-- The `chain` field uses DeBank's IDs (`eth`, `bsc`, `matic`, `arb`, `op`, `base`, etc.) — translate to user-friendly names when reporting
-- Stale data: DeBank refresh varies; freshly-opened positions may not show for 5-15 min
-- If you get `balance_error` or `positions_error`, the DeBank API is rate-limited / down — retry once, then surface the error honestly
-
-## Pairs well with
-
-- `vike labels <addr>` — combine label provenance with DeFi positions for a full institutional view
-- `vike wallet summary <addr>` — on-chain transfer activity vs DeFi positions for the same wallet

package/skills/vike-fund-holdings/SKILL.md

@@ -1,53 +0,0 @@
----
-name: vike-fund-holdings
-description: Top labeled fund / market-maker / treasury / CEX wallets ranked by recent net inflow USD. Use when the user asks "what are funds buying" / "which whales are accumulating" / "track institutional flows".
-allowed-tools: Bash(vike:*)
----
-
-# vike-fund-holdings
-
-## Command
-
-```bash
-vike funds [--kind funds|cex|mm|treasury] [--window 7d|30d|90d|180d|all] [--limit N] [--json]
-```
-
-## Examples
-
-```bash
-vike funds --kind funds --window 30d --limit 10
-vike funds --kind cex --window 7d --limit 20
-vike funds --kind treasury --window 90d
-vike funds --kind mm --window 30d
-```
-
-## Kind filters
-
-| Kind | Includes |
-|---|---|
-| `funds` (default) | Treasury wallets + market-makers + custody anchors + Fund / Hedge / VC / Foundation / DAO categories |
-| `cex` | Exchanges (Binance, Coinbase, Bybit, OKX, etc.) |
-| `mm` | Market-makers (Wintermute, GSR, Jump, etc.) |
-| `treasury` | DAO + corporate treasury wallets |
-
-## Output columns
-
-`wallet`, `entity`, `label` (raw provider tag, when available), `wallet_type`, `confidence`, `net_flow_usd` (window), `volume_usd` (window), `tx_count` (window)
-
-## Reading
-
-- **Sort is descending by net_flow_usd** — top accumulators come first
-- A wallet with `entity = "Binance"` and `wallet_type = "cex"` showing massive net inflow = users depositing TO Binance (bearish for prices on the way in), or Binance moving inventory internally
-- `confidence = "High"` rows have multi-source label agreement; `Low` rows are heuristic-only
-- Negative `net_flow_usd` in a list sorted descending = no accumulators above this row; everyone is net-selling
-
-## Anti-patterns
-
-- Don't quote "Binance bought $50M of X" from this view — it's wallet-level flow, not per-token attribution. For per-token, use `vike token holders` then filter for CEX labels.
-- Treasury wallets often have huge one-time inflows (e.g. ICO unlocks); a single 30d window can be misleading. Check `--window all` for context.
-
-## Pairs well with
-
-- `vike labels <addr>` — drill into any specific wallet's full label cascade
-- `vike token holders <addr>` — see which of these wallets hold a specific token
-- `vike-smart-money-discovery` — find unlabeled smart wallets vs labeled funds

package/skills/vike-ohlcv/SKILL.md

@@ -1,65 +0,0 @@
----
-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-options-flow/SKILL.md

@@ -1,49 +0,0 @@
----
-name: vike-options-flow
-description: Deribit options flow — call/put volume, put-call ratios, and direction signals for BTC / ETH / SOL. Use when the user asks "options flow on X" / "put call ratio" / "options positioning".
-allowed-tools: Bash(vike:*)
----
-
-# vike-options-flow
-
-## Command
-
-```bash
-vike options flow --symbol BTC|ETH|SOL [--window 1d|1w|1m] [--json]
-```
-
-Default: BTC, 1d.
-
-## Output
-
-Per-window aggregates: call volume, put volume, put-call ratio, net delta, open-interest deltas.
-
-## Reading the put-call ratio (PCR)
-
-| PCR (volume basis) | Read |
-|---|---|
-| < 0.5 | **Aggressive call buying** — bullish positioning, or call-overwrite unwind |
-| 0.5–0.8 | Normal bullish |
-| 0.8–1.2 | Balanced |
-| 1.2–1.8 | Bearish hedging or directional put buying |
-| > 1.8 | Heavy put demand — fear / hedge spike |
-
-PCR is **not a contrarian signal** on its own. Cross-reference with spot price action and funding:
-- High PCR + price falling + negative funding = real bearish capitulation
-- High PCR + price flat + positive funding = hedging into a rally (not panic)
-
-## Window choice
-
-- `1d` — intraday sentiment shifts, useful around major events
-- `1w` — positioning trend; cleaner read for narrative
-- `1m` — structural positioning; useful for IV-rank and term-structure context
-
-## Anti-patterns
-
-- Don't quote raw call/put volume without context — Deribit's BTC notional is in the tens of billions weekly; a $100M day means little in isolation.
-- Don't conflate flow (new positions) with open interest (cumulative). Flow is the change; OI is the stock.
-
-## Pairs well with
-
-- `vike-perp-funding-arb` for the corresponding perp positioning
-- `vike-perp-screener` for the broader market read

package/skills/vike-web-fetch/SKILL.md

@@ -1,55 +0,0 @@
----
-name: vike-web-fetch
-description: Fetch a URL's content (via Tavily extract) and optionally answer a question about it using Cerebras Llama 3.3 70B. Use when the user gives a URL and asks "what does this page say" / "summarise X" / "extract Y from this article".
-allowed-tools: Bash(vike:*)
----
-
-# vike-web-fetch
-
-## Command
-
-```bash
-vike web fetch <url> [--ask "<question>"] [--json]
-```
-
-## Examples
-
-```bash
-vike web fetch https://example.com/article
-vike web fetch https://example.com/article --ask "what's the launch date?"
-vike web fetch https://docs.hyperliquid.xyz/funding --ask "how often does funding settle?"
-```
-
-## Output
-
-```json
-{
-  "url": "https://...",
-  "content_length": 12345,
-  "content": "First 8K chars of extracted content...",
-  "answer": "Answer to your question if --ask was provided"
-}
-```
-
-If `--ask` is omitted, you get raw extracted content only.
-
-## How it works
-
-1. Tries Tavily's `/extract` endpoint first — returns clean markdown-like text
-2. Falls back to raw HTTP GET if Tavily extract is unavailable
-3. If `--ask` is provided, sends content + question to Cerebras Llama 3.3 70B for a focused answer
-
-## Why we use Cerebras (not Gemini / OpenAI)
-
-Cerebras Llama 3.3 70B is ~10x cheaper than Gemini 2.5 Flash and ~3-5x faster (1000+ tok/sec inference). Same answer quality for short Q&A on supplied content.
-
-## Anti-patterns
-
-- Don't fetch pay-walled URLs and expect text — you'll get a paywall page. Cite the URL and tell the user instead.
-- Don't fetch huge files (PDFs > 10MB, videos) — the extract will be truncated and likely garbage.
-- Don't ask `--ask` questions the content can't possibly answer — Cerebras will hallucinate. Stay tight to what's on the page.
-
-## Pairs well with
-
-- `vike web search` — find URLs to fetch first
-- `vike-web-research` — composite multi-step research workflow

package/skills/vike-web-research/SKILL.md

@@ -1,58 +0,0 @@
----
-name: vike-web-research
-description: Multi-step web research playbook — search → fetch the most relevant URL → synthesize answer. Use when the user asks an open question that requires fresh web info ("what did Trump say about crypto yesterday", "latest exchange listing announcement", "summarize the latest Pendle update").
-allowed-tools: Bash(vike:*)
----
-
-# vike-web-research
-
-Composite playbook combining `vike web search` and `vike web fetch` for cross-source synthesis.
-
-## Workflow
-
-### 1. Search (gather candidate URLs)
-
-```bash
-vike web search "<query>" --max 5 --json
-```
-
-Capture the top results' URLs and titles. If the response includes an `answer` field, that's often enough for simple factual queries — surface it directly and skip step 2.
-
-### 2. Fetch (only when search snippets are insufficient)
-
-```bash
-vike web fetch <top-result-url> --ask "<focused question>" --json
-```
-
-Fetch only the highest-scoring (Tavily) or most-credible (Serper) URL. Re-fetching all 5 search results burns credits and adds noise.
-
-### 3. Synthesize
-
-> **Question:** `<user query>`
-> **Answer (from `<source URL>`):** `<extracted answer>`
-> **Other relevant sources:** `<url1>`, `<url2>` (with one-line summaries each)
-
-Always link the source URL so the user can verify.
-
-## When to skip the workflow
-
-- **One-shot fact lookup** (price, date, contract address) → if `web search` returns it in the `answer` field, just quote that
-- **The user already gave you a URL** → skip search, jump to `web fetch`
-- **On-chain question** → don't web-research; use vike's on-chain tools (`token holders`, `wallet labels`, `perp funding`, etc.)
-
-## Anti-patterns
-
-- Don't fetch 5 URLs and average them — pick the most authoritative
-- Don't quote Reddit / Twitter as primary sources for hard claims (price, dates, addresses); use them for sentiment only
-- Don't combine web research with `vike-smart-money-discovery` results without saying so — they're different evidence types
-
-## Cost
-
-- Step 1: 2 credits (Tavily basic)
-- Step 2: 3 credits (web_fetch with --ask = Tavily extract + Cerebras Q&A)
-- Total: ~5 credits per research round
-
-## Pairs well with
-
-- `vike-token-research` — combine on-chain data with off-chain news
-- `vike-polymarket-screener` — narrative-driven prediction markets often need news context

package/skills/vike-web-search/SKILL.md

@@ -1,60 +0,0 @@
----
-name: vike-web-search
-description: Web search using Tavily (LLM-tuned snippets, primary) with Serper Google fallback. Use when you need current events, project announcements, exchange listing news, or anything not in the vike on-chain databases.
-allowed-tools: Bash(vike:*)
----
-
-# vike-web-search
-
-## Command
-
-```bash
-vike web search "<query>" [--max N] [--depth basic|advanced] [--json]
-```
-
-The query can contain multiple words (no quoting required if you don't have shell-special chars).
-
-## Examples
-
-```bash
-vike web search "hyperliquid funding rate explained"
-vike web search "polymarket trump 2026 latest" --max 8
-vike web search "ETH ETF inflows last week" --depth advanced
-```
-
-## Output
-
-```json
-{
-  "provider": "tavily",
-  "query": "...",
-  "answer": "Optional one-paragraph synthesised answer (Tavily only)",
-  "results": [
-    { "title": "...", "url": "...", "snippet": "...", "score": 0.88 },
-    ...
-  ]
-}
-```
-
-`score` is a 0-1 relevance from Tavily (higher = more relevant). Serper doesn't include it.
-
-## When to use vs on-chain tools
-
-- **News / sentiment / project context** → `vike web search`
-- **On-chain flows / wallet activity / token prices** → use the dedicated `vike token`/`vike wallet`/`vike perp` tools first
-- **"What did X tweet" / "did Binance announce Y"** → web search
-
-## Cost note
-
-Web search calls cost 2 credits + an external API fee on our side. Use it when you genuinely need fresh / non-onchain info, not as a first-resort.
-
-## Anti-patterns
-
-- Don't web-search for things our on-chain tools answer faster ("top wallets holding PEPE" → `vike token holders` is faster, cheaper, and more accurate)
-- Don't request `--max > 5` unless you genuinely need a wide net — agents waste tokens summarising 10 results when 3 would do
-- `--depth advanced` doubles the cost; reserve for hard-to-answer queries
-
-## Pairs well with
-
-- `vike-web-fetch` — once you have a promising URL, fetch its full content
-- `vike-web-research` — composite playbook for multi-step research

package/src/commands/ohlcv.js

@@ -1,33 +0,0 @@
-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/commands/options.js

@@ -1,24 +0,0 @@
-import { callTool } from '../mcp-client.js';
-import { emit, emitError } from '../format.js';
-
-export function registerOptions(program) {
-  const cmd = program
-    .command('options')
-    .description('Deribit options flow');
-
-  cmd
-    .command('flow')
-    .description('Call/put flow, volume, and put-call ratios')
-    .option('--symbol <s>', 'BTC | ETH | SOL', 'BTC')
-    .option('--window <w>', '1d | 1w | 1m', '1d')
-    .option('--json', 'Emit JSON')
-    .action(async (opts) => {
-      try {
-        const r = await callTool('options_flow', {
-          symbol: opts.symbol,
-          window: opts.window,
-        });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
-}

package/src/commands/web.js

@@ -1,41 +0,0 @@
-import { callTool } from '../mcp-client.js';
-import { emit, emitError } from '../format.js';
-import { parseInt10 } from '../util.js';
-
-export function registerWeb(program) {
-  const cmd = program
-    .command('web')
-    .description('Web search + fetch (Tavily / Serper / Cerebras)');
-
-  cmd
-    .command('search <query...>')
-    .description('Web search (Tavily primary, Serper Google fallback)')
-    .option('--max <n>', 'Max results (default 5, max 10)', '5')
-    .option('--depth <d>', 'Tavily depth: basic | advanced', 'basic')
-    .option('--json', 'Emit JSON')
-    .action(async (queryParts, opts) => {
-      try {
-        const r = await callTool('web_search', {
-          query: queryParts.join(' '),
-          max_results: parseInt10(opts.max, 5),
-          search_depth: opts.depth,
-        });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
-
-  cmd
-    .command('fetch <url>')
-    .description('Fetch URL and optionally answer a question about it')
-    .option('--ask <question>', 'Question to answer from the content (uses Cerebras)')
-    .option('--json', 'Emit JSON')
-    .action(async (url, opts) => {
-      try {
-        const r = await callTool('web_fetch', {
-          url,
-          question: opts.ask,
-        });
-        emit(r, opts);
-      } catch (err) { emitError(err, opts); }
-    });
-}