@vike-io/cli 0.11.0 → 0.12.1

package/skills/vike/SKILL.md

@@ -1,15 +1,21 @@
 ---
 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.
+This skill is for anyone who asks an AI agent about crypto data: who is buying a token, what a wallet holds, what Hyperliquid or Polymarket traders are doing right now. It tells the agent which vike tool answers which question and how to read the result, so it does not guess or invent numbers. It reads its data from vike.io and needs a free vike API key.
+
+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>`
 
+## What it does and who it is for
+
+It is for traders, researchers and developers who use an AI agent to look at crypto data. With this skill the agent knows which vike tool to call for wallets, tokens, smart money, Hyperliquid perps, Polymarket markets and alerts. It also knows how to read each answer and what the tools cannot do, so it reports real numbers instead of guesses. The data comes from vike.io and a free vike API key is needed.
+
 ---
 
 ## Critical Rules
@@ -53,7 +59,7 @@ If the user has no API key yet, tell them:
 >
 > Per-key default cap: 2000 requests/hour. Most calls return in <500ms.
 
-If using the MCP server directly (without the CLI), send the key as a header:
+If using the MCP server directly (without the CLI), authenticate with the key in this header:
 ```
 X-API-KEY: vk_...
 ```
@@ -66,8 +72,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 +84,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
@@ -124,22 +124,7 @@ vike wallet summary 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json
 vike perp funding --symbol BTC --window 24h --json
 ```
 
-**B) Via MCP JSON-RPC (recommended when an MCP connector is available).** All 34 tools live at `https://vike.io/mcp`:
-```http
-POST https://vike.io/mcp
-X-API-KEY: vk_...
-Content-Type: application/json
-
-{
-  "jsonrpc": "2.0",
-  "id": 1,
-  "method": "tools/call",
-  "params": {
-    "name": "wallet_summary",
-    "arguments": {"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum"}
-  }
-}
-```
+**B) Via an MCP connector (recommended when your client has one).** All 31 tools live at `https://vike.io/mcp`. Connect the client to that address with the `X-API-KEY` header above, then call a tool by name with its arguments, for example `wallet_summary` with `address` set to a full 0x address and `chain` set to `ethereum`.
 
 Run `vike schema --pretty` (or call MCP `tools/list`) to see the live arg shape for every tool. Always read the schema before constructing arguments — defaults and enum values change.
 
@@ -147,19 +132,17 @@ Run `vike schema --pretty` (or call MCP `tools/list`) to see the live arg shape
 
 ## Per-service tool reference
 
-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).
+For deeper per-tool workflows (multi-step recipes, common pitfalls, output schemas), see the `skills/` directory in this repo. The router lives at `vike-router`.
 
 ### 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) |
+| `token_search` | Symbol/name → contract address + chain + market cap | `vike-token-search` |
+| `token_transfers` | Recent transfers with USD values; supports `--min-usd`, time windows | `vike-token-transfers` |
+| `token_holders` | Top holders + concentration metrics | `vike-token-holders` |
+| `token_screener` | Filter tokens by smart-money inflow, age, liquidity, sector | `vike-token-screener` |
 
 **Key chains:** `ethereum`, `bsc`, `base`, `arbitrum`, `hyperevm` (EVM); `bitcoin`, `solana`, `tron`, `xmr`, `zec`, `dash` (non-EVM, limited tool support).
 
@@ -170,28 +153,27 @@ Profile, PnL, transactions, comparison, tracing, counterparty graph.
 
 | Tool | Description | Skill |
 |---|---|---|
-| `wallet_summary` | One-call profile: PnL, top holdings, recent activity, labels | [vike-wallet-summary](skills/vike-wallet-summary/SKILL.md) |
-| `wallet_discover` | Leaderboard of top wallets by PnL/inflow on a token | [vike-wallet-discover](skills/vike-wallet-discover/SKILL.md), [vike-smart-money-discovery](skills/vike-smart-money-discovery/SKILL.md) |
-| `wallet_transactions` | Raw recent transactions (tx_hash, ts, from, to, token, usd) | [vike-wallet-transactions](skills/vike-wallet-transactions/SKILL.md) |
-| `wallet_compare` | Side-by-side metrics for 2+ wallets | [vike-wallet-compare](skills/vike-wallet-compare/SKILL.md) |
-| `wallet_trace` | BFS funds tracing N hops from a starting wallet | [vike-wallet-trace](skills/vike-wallet-trace/SKILL.md) |
-| `wallet_counterparties` | Top counterparties (who they send to / receive from) | [vike-wallet-counterparties](skills/vike-wallet-counterparties/SKILL.md) |
-| `wallet_pnl_history` | Daily PnL timeseries over `--days N` | [vike-wallet-pnl-history](skills/vike-wallet-pnl-history/SKILL.md) |
-| `wallet_token_balances` | Current token balances (Moralis-backed) | [vike-wallet-balances](skills/vike-wallet-balances/SKILL.md) |
-| `wallet_ens` | ENS name ↔ address (local cache: 477K wallets pre-resolved) | [vike-wallet-ens](skills/vike-wallet-ens/SKILL.md) |
-| `wallet_batch_labels` | Bulk-label up to 100 addresses in one call | [vike-wallet-batch](skills/vike-wallet-batch/SKILL.md) |
+| `wallet_summary` | One-call profile: PnL, top holdings, recent activity, labels | `vike-wallet-summary` |
+| `wallet_discover` | Leaderboard of top wallets by PnL/inflow on a token | `vike-wallet-discover`, `vike-smart-money-discovery` |
+| `wallet_transactions` | Raw recent transactions (tx_hash, ts, from, to, token, usd) | `vike-wallet-transactions` |
+| `wallet_compare` | Side-by-side metrics for 2+ wallets | `vike-wallet-compare` |
+| `wallet_trace` | BFS funds tracing N hops from a starting wallet | `vike-wallet-trace` |
+| `wallet_counterparties` | Top counterparties (who they send to / receive from) | `vike-wallet-counterparties` |
+| `wallet_pnl_history` | Daily PnL timeseries over `--days N` | `vike-wallet-pnl-history` |
+| `wallet_token_balances` | Current token balances (Moralis-backed) | `vike-wallet-balances` |
+| `wallet_ens` | ENS name ↔ address (local cache: 477K wallets pre-resolved) | `vike-wallet-ens` |
+| `wallet_batch_labels` | Bulk-label up to 100 addresses in one call | `vike-wallet-batch` |
 
 **Address shape:** always full 0x-prefixed hex (42 chars). Never truncate when reporting back to the user.
 
 ---
 
-### 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) |
+| `wallet_label_provenance` | Why a wallet got a given label (sources + confidence) | `vike-wallet-label-provenance` |
 
 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.
 
@@ -202,8 +184,8 @@ Vike's label cascade is multi-source — when an answer hinges on "is this reall
 
 | Tool | Description | Skill |
 |---|---|---|
-| `perp_funding` | Funding rates per symbol per venue + 24h/7d averages | [vike-perp-funding-arb](skills/vike-perp-funding-arb/SKILL.md) |
-| `perp_spreads` | Mark-price spreads of the same symbol across venues | [vike-perp-spread-arb](skills/vike-perp-spread-arb/SKILL.md), [vike-cross-venue-perps](skills/vike-cross-venue-perps/SKILL.md) |
+| `perp_funding` | Funding rates per symbol per venue + 24h/7d averages | `vike-perp-funding-arb` |
+| `perp_spreads` | Mark-price spreads of the same symbol across venues | `vike-perp-spread-arb`, `vike-cross-venue-perps` |
 
 ---
 
@@ -212,21 +194,20 @@ On-chain perps data: snapshots, fills, ledger, funding, attribution.
 
 | Tool | Description | Skill |
 |---|---|---|
-| `hl_perp_top_traders` | Top HL traders by PnL/volume over a window | [vike-hl-top-traders](skills/vike-hl-top-traders/SKILL.md), [vike-hl-trader-profile](skills/vike-hl-trader-profile/SKILL.md) |
-| `hl_position_match` | Reverse-lookup: share-card details (coin/side/lev/entry) → wallet holding that open position | [vike-hl-position-match](skills/vike-hl-position-match/SKILL.md) |
+| `hl_perp_top_traders` | Top HL traders by PnL/volume over a window | `vike-hl-top-traders`, `vike-hl-trader-profile` |
+| `hl_position_match` | Reverse-lookup: share-card details (coin/side/lev/entry) → wallet holding that open position | `vike-hl-position-match` |
 
-For per-symbol HL screening / individual trader deep-dive, use [vike-perp-screener](skills/vike-perp-screener/SKILL.md) and [vike-hl-trader-profile](skills/vike-hl-trader-profile/SKILL.md).
+For per-symbol HL screening / individual trader deep-dive, use `vike-perp-screener` and `vike-hl-trader-profile`.
 
 ---
 
-### 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` |
+| `polymarket_ohlcv` | Candles for ONE Polymarket outcome token (price = probability, 0–1); needs `token_id`, not a condition_id | `vike-candles` |
 
 ---
 
@@ -235,21 +216,10 @@ Prediction markets — markets, traders, smart-money.
 
 | Tool | Description | Skill |
 |---|---|---|
-| `polymarket_markets` | Active markets sorted by volume / liquidity / volatility | [vike-polymarket-markets](skills/vike-polymarket-markets/SKILL.md), [vike-polymarket-screener](skills/vike-polymarket-screener/SKILL.md) |
-| `polymarket_market_detail` | Single market: outcomes, holders, recent trades, time-to-resolution | [vike-polymarket-market-detail](skills/vike-polymarket-market-detail/SKILL.md) |
-| `polymarket_wallet` | One trader's positions, PnL, win rate | [vike-polymarket-trader](skills/vike-polymarket-trader/SKILL.md) |
-| `polymarket_smart_money` | Top-PnL Polymarket traders + their current open positions | [vike-polymarket-smart-money](skills/vike-polymarket-smart-money/SKILL.md) |
-
----
-
-### 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.
+| `polymarket_markets` | Active markets sorted by volume / liquidity / volatility | `vike-polymarket-markets`, `vike-polymarket-screener` |
+| `polymarket_market_detail` | Single market: outcomes, holders, recent trades, time-to-resolution | `vike-polymarket-market-detail` |
+| `polymarket_wallet` | One trader's positions, PnL, win rate | `vike-polymarket-trader` |
+| `polymarket_smart_money` | Top-PnL Polymarket traders + their current open positions | `vike-polymarket-smart-money` |
 
 ---
 
@@ -258,27 +228,15 @@ Create + manage alerts; deliver to email, Telegram, Discord, Webhook.
 
 | Tool | Description | Skill |
 |---|---|---|
-| `alerts_list` | List user's existing alerts | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
-| `alerts_create` | Create a new price/transfer/funding alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
-| `alerts_edit` | Edit an existing alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
-| `alerts_delete` | Delete an alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
-| `alerts_list_channels` | List user's registered delivery channels | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
-| `alerts_register_webhook` | Register an HTTPS webhook (HMAC-signed deliveries) | [vike-alerts-webhook](skills/vike-alerts-webhook/SKILL.md) |
+| `alerts_list` | List user's existing alerts | `vike-alerts-setup` |
+| `alerts_create` | Create a new price/transfer/funding alert | `vike-alerts-setup` |
+| `alerts_edit` | Edit an existing alert | `vike-alerts-setup` |
+| `alerts_delete` | Delete an alert | `vike-alerts-setup` |
+| `alerts_list_channels` | List user's registered delivery channels | `vike-alerts-setup` |
+| `alerts_register_webhook` | Register an HTTPS webhook (HMAC-signed deliveries) | `vike-alerts-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 +254,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-hl-position-match/SKILL.md

@@ -81,6 +81,6 @@ The response includes `tolerance_used` so the caller knows which band matched (`
 
 ## Pairs well with
 
-- [vike-wallet-summary](../vike-wallet-summary/SKILL.md) — once you have the address, get the trader's HL profile + multi-chain identity.
-- [vike-hl-top-traders](../vike-hl-top-traders/SKILL.md) — check if the matched wallet is on a leaderboard.
-- [vike-wallet-label-provenance](../vike-wallet-label-provenance/SKILL.md) — find out if the wallet is a known CEX/fund/MM rather than a retail trader.
+- `vike-wallet-summary` — once you have the address, get the trader's HL profile + multi-chain identity.
+- `vike-hl-top-traders` — check if the matched wallet is on a leaderboard.
+- `vike-wallet-label-provenance` — find out if the wallet is a known CEX/fund/MM rather than a retail trader.

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/init.js

@@ -33,7 +33,7 @@ export function registerInit(program) {
 
       console.log('Verifying connection to vike.io/mcp ...');
       const { status, body } = await ping({ apiKey: key });
-      if (status !== 200) {
+      if (status !== 200 || body?.error) {
         console.error(`Endpoint returned HTTP ${status}: ${JSON.stringify(body)}`);
         process.exitCode = 1;
         return;