@vike-io/cli 0.12.1 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +26 -26
  3. package/package.json +1 -2
  4. package/scripts/postinstall.js +3 -3
  5. package/skills/vike/SKILL.md +35 -35
  6. package/skills/vike-alerts-setup/SKILL.md +12 -12
  7. package/skills/vike-alerts-webhook/SKILL.md +5 -5
  8. package/skills/vike-candles/SKILL.md +10 -10
  9. package/skills/vike-core/SKILL.md +12 -12
  10. package/skills/vike-cross-venue-perps/SKILL.md +3 -3
  11. package/skills/vike-hl-position-match/SKILL.md +3 -3
  12. package/skills/vike-hl-top-traders/SKILL.md +2 -2
  13. package/skills/vike-hl-trader-profile/SKILL.md +6 -6
  14. package/skills/vike-perp-funding-arb/SKILL.md +4 -4
  15. package/skills/vike-perp-screener/SKILL.md +4 -4
  16. package/skills/vike-perp-spread-arb/SKILL.md +3 -3
  17. package/skills/vike-polymarket-market-detail/SKILL.md +5 -5
  18. package/skills/vike-polymarket-markets/SKILL.md +5 -5
  19. package/skills/vike-polymarket-screener/SKILL.md +4 -4
  20. package/skills/vike-polymarket-smart-money/SKILL.md +4 -4
  21. package/skills/vike-polymarket-trader/SKILL.md +4 -4
  22. package/skills/vike-router/SKILL.md +8 -8
  23. package/skills/vike-smart-money-discovery/SKILL.md +5 -5
  24. package/skills/vike-token-holders/SKILL.md +7 -7
  25. package/skills/vike-token-research/SKILL.md +4 -4
  26. package/skills/vike-token-screener/SKILL.md +8 -8
  27. package/skills/vike-token-search/SKILL.md +4 -4
  28. package/skills/vike-token-transfers/SKILL.md +4 -4
  29. package/skills/vike-wallet-balances/SKILL.md +6 -6
  30. package/skills/vike-wallet-batch/SKILL.md +6 -6
  31. package/skills/vike-wallet-compare/SKILL.md +5 -5
  32. package/skills/vike-wallet-counterparties/SKILL.md +7 -7
  33. package/skills/vike-wallet-discover/SKILL.md +4 -4
  34. package/skills/vike-wallet-ens/SKILL.md +6 -6
  35. package/skills/vike-wallet-label-provenance/SKILL.md +4 -4
  36. package/skills/vike-wallet-pnl-history/SKILL.md +5 -5
  37. package/skills/vike-wallet-portfolio/SKILL.md +6 -6
  38. package/skills/vike-wallet-summary/SKILL.md +5 -5
  39. package/skills/vike-wallet-trace/SKILL.md +6 -6
  40. package/skills/vike-wallet-transactions/SKILL.md +9 -9
  41. package/src/auth.js +1 -1
  42. package/src/chains.js +1 -1
  43. package/src/commands/doctor.js +2 -2
  44. package/src/commands/init.js +1 -1
  45. package/src/commands/install.js +5 -5
  46. package/src/commands/labels.js +1 -1
  47. package/src/index.js +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.13.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Skills: `allowed-tools` is `Bash(vike-data:*)` and `vike-core` requires the `vike-data` binary. 0.13.0 renamed the command but left all 35 skills granting `Bash(vike:*)`, which does not match `vike-data …`, so an agent was asked to approve, or was refused, every call.
8
+
9
+ ## 0.13.0
10
+
11
+ ### Minor Changes
12
+
13
+ - The command is `vike-data`. The `vike` binary is removed with no alias: run `vike-data init`, `vike-data token search PEPE` and so on. README, `--help`, error messages and all 36 skill playbooks now name `vike-data`; installed skills that still call `vike` need `npx skills add vike-io/vike-data-cli` again. The skill names, the umbrella skill `vike` and its install path `~/.claude/skills/vike/` are unchanged.
14
+
3
15
  ## 0.12.1
4
16
 
5
17
  ### Patch Changes
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @vike-io/cli — the Vike Data API from your terminal and your AI agent
2
2
 
3
- > Repo + package: `@vike-io/cli` (npm) · `vike-io/vike-data-cli` (GitHub) · binary: `vike` (alias `vike-data`)
3
+ > Repo + package: `@vike-io/cli` (npm) · `vike-io/vike-data-cli` (GitHub) · binary: `vike-data`
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@vike-io/cli.svg)](https://www.npmjs.com/package/@vike-io/cli)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -22,7 +22,7 @@ at all. Market data from centralised exchanges is not offered through the REST A
22
22
  ## Install
23
23
 
24
24
  ```bash
25
- # The CLI (Node.js >= 22.12). Installs the `vike` binary.
25
+ # The CLI (Node.js >= 22.12). Installs the `vike-data` binary.
26
26
  npm install -g @vike-io/cli
27
27
 
28
28
  # OR install only the skill playbooks into your AI agent (Claude Code, Cursor,
@@ -36,16 +36,16 @@ Get a free key at [vike.io/account?tab=api-keys](https://vike.io/account?tab=api
36
36
  with `vk_`), then:
37
37
 
38
38
  ```bash
39
- vike init # paste the key; saves ~/.vike/config.json, checks vike.io/mcp
40
- vike doctor # Node version, key, MCP connectivity, tool list
41
- vike token search PEPE # first query
42
- vike perp top-traders --window 7d # Hyperliquid wallets ranked by PnL
43
- vike candles hl BTC --interval 1h --limit 48
44
- vike polymarket markets --category Crypto # trending markets by 24h volume
39
+ vike-data init # paste the key; saves ~/.vike/config.json, checks vike.io/mcp
40
+ vike-data doctor # Node version, key, MCP connectivity, tool list
41
+ vike-data token search PEPE # first query
42
+ vike-data perp top-traders --window 7d # Hyperliquid wallets ranked by PnL
43
+ vike-data candles hl BTC --interval 1h --limit 48
44
+ vike-data polymarket markets --category Crypto # trending markets by 24h volume
45
45
  ```
46
46
 
47
47
  The key is read from `VIKE_API_KEY` first, then from `~/.vike/config.json`
48
- (`vike login --api-key vk_...` writes it, `vike logout` removes it).
48
+ (`vike-data login --api-key vk_...` writes it, `vike-data logout` removes it).
49
49
 
50
50
  ## Free datasets
51
51
 
@@ -132,24 +132,24 @@ not only the HTTP status. A rate-limited call gets HTTP 429 with `Retry-After: 6
132
132
 
133
133
  ## CLI commands
134
134
 
135
- Every data command is one `tools/call` to the MCP server. `vike <group> --help` lists the flags;
136
- `vike schema --pretty` prints every tool the server exposes, with its parameters.
135
+ Every data command is one `tools/call` to the MCP server. `vike-data <group> --help` lists the flags;
136
+ `vike-data schema --pretty` prints every tool the server exposes, with its parameters.
137
137
 
138
138
  | Command | Subcommands | MCP tool |
139
139
  |---|---|---|
140
- | `vike token` | `search`, `transfers`, `screener`, `holders` (`--chain ethereum\|bsc\|base`) | `token_search`, `token_transfers`, `token_screener`, `token_holders` |
141
- | `vike wallet` | `summary`, `transactions` (`txs`), `compare`, `trace`, `batch`, `counterparties`, `pnl-history`, `balances`, `ens`, `discover` | `wallet_summary`, `wallet_transactions`, `wallet_compare`, `wallet_trace`, `wallet_batch_labels`, `wallet_counterparties`, `wallet_pnl_history`, `wallet_token_balances`, `wallet_ens`, `wallet_discover` |
142
- | `vike labels <address>` | multi-source label provenance for one wallet | `wallet_label_provenance` |
143
- | `vike perp` | `top-traders`, `find-position` (Hyperliquid); `funding`, `spreads` (cross-venue funding rates and spot-perp spreads) | `hl_perp_top_traders`, `hl_position_match`, `perp_funding`, `perp_spreads` |
144
- | `vike candles` | `hl <symbol>` (Hyperliquid perp or spot, from executed fills), `polymarket <token_id>` (one outcome token) | `hl_ohlcv`, `polymarket_ohlcv` |
145
- | `vike polymarket` (`pm`) | `markets`, `market <condition_id>`, `wallet <address>`, `smart-money` | `polymarket_markets`, `polymarket_market_detail`, `polymarket_wallet`, `polymarket_smart_money` |
146
- | `vike alerts` | `list`, `channels`, `create`, `edit`, `delete`, `register-webhook` (email, Discord, or an HTTPS webhook, HMAC-signed when you set a secret) | `alerts_*` |
140
+ | `vike-data token` | `search`, `transfers`, `screener`, `holders` (`--chain ethereum\|bsc\|base`) | `token_search`, `token_transfers`, `token_screener`, `token_holders` |
141
+ | `vike-data wallet` | `summary`, `transactions` (`txs`), `compare`, `trace`, `batch`, `counterparties`, `pnl-history`, `balances`, `ens`, `discover` | `wallet_summary`, `wallet_transactions`, `wallet_compare`, `wallet_trace`, `wallet_batch_labels`, `wallet_counterparties`, `wallet_pnl_history`, `wallet_token_balances`, `wallet_ens`, `wallet_discover` |
142
+ | `vike-data labels <address>` | multi-source label provenance for one wallet | `wallet_label_provenance` |
143
+ | `vike-data perp` | `top-traders`, `find-position` (Hyperliquid); `funding`, `spreads` (cross-venue funding rates and spot-perp spreads) | `hl_perp_top_traders`, `hl_position_match`, `perp_funding`, `perp_spreads` |
144
+ | `vike-data candles` | `hl <symbol>` (Hyperliquid perp or spot, from executed fills), `polymarket <token_id>` (one outcome token) | `hl_ohlcv`, `polymarket_ohlcv` |
145
+ | `vike-data polymarket` (`pm`) | `markets`, `market <condition_id>`, `wallet <address>`, `smart-money` | `polymarket_markets`, `polymarket_market_detail`, `polymarket_wallet`, `polymarket_smart_money` |
146
+ | `vike-data alerts` | `list`, `channels`, `create`, `edit`, `delete`, `register-webhook` (email, Discord, or an HTTPS webhook, HMAC-signed when you set a secret) | `alerts_*` |
147
147
  | setup | `init`, `login`, `logout`, `doctor`, `schema`, `install` | — |
148
148
 
149
149
  Output is a table on a terminal and JSON with `--json` or whenever stdout is piped:
150
150
 
151
151
  ```bash
152
- vike token search BTC --json | jq '.'
152
+ vike-data token search BTC --json | jq '.'
153
153
  ```
154
154
 
155
155
  ## Examples
@@ -183,14 +183,14 @@ npx skills add vike-io/vike-data-cli --list # see them first
183
183
  npx skills add vike-io/vike-data-cli # install
184
184
 
185
185
  # Or, from the installed CLI, write the umbrella skill into each agent's location:
186
- vike install --claude # ~/.claude/skills/vike/SKILL.md
187
- vike install --cursor # ./.cursorrules
188
- vike install --copilot # ./.github/copilot-instructions.md
189
- vike install --agents # ./AGENTS.md
190
- vike install --all # all four
186
+ vike-data install --claude # ~/.claude/skills/vike/SKILL.md
187
+ vike-data install --cursor # ./.cursorrules
188
+ vike-data install --copilot # ./.github/copilot-instructions.md
189
+ vike-data install --agents # ./AGENTS.md
190
+ vike-data install --all # all four
191
191
  ```
192
192
 
193
- `vike install` replaces only its own `<!-- vike-skill:begin -->` ... `<!-- vike-skill:end -->`
193
+ `vike-data install` replaces only its own `<!-- vike-skill:begin -->` ... `<!-- vike-skill:end -->`
194
194
  block in files it does not own.
195
195
 
196
196
  ## Environment
@@ -205,7 +205,7 @@ block in files it does not own.
205
205
  Telemetry sends the command name, the flag names (never their values), the duration, an error code
206
206
  and a random device id. It never sends what you queried, and it is off when `CI` is set.
207
207
 
208
- `vike` here is the Data API client. The Vike Trader platform has its own, separate command line,
208
+ `vike-data` is the Data API client. The Vike Trader platform has its own, separate command line,
209
209
  `vike-cli` ([docs](https://vike.io/docs/trader/cli)).
210
210
 
211
211
  ## License
package/package.json CHANGED
@@ -3,12 +3,11 @@
3
3
  "publishConfig": {
4
4
  "access": "public"
5
5
  },
6
- "version": "0.12.1",
6
+ "version": "0.13.1",
7
7
  "description": "CLI, agent skills and MCP client for the free Vike Data API: a Polymarket full-L2 order-book archive in Parquet (CC BY 4.0), Hyperliquid positions, fills and cohorts, and labelled Ethereum/BNB wallets",
8
8
  "type": "module",
9
9
  "main": "src/index.js",
10
10
  "bin": {
11
- "vike": "./src/index.js",
12
11
  "vike-data": "./src/index.js"
13
12
  },
14
13
  "files": [
@@ -26,9 +26,9 @@ try {
26
26
  ' @vike-io/cli installed.',
27
27
  '',
28
28
  ' Next steps:',
29
- ' vike init — interactive setup',
30
- ' vike doctor — verify your install',
31
- ' vike token search BTC — your first query',
29
+ ' vike-data init — interactive setup',
30
+ ' vike-data doctor — verify your install',
31
+ ' vike-data token search BTC — your first query',
32
32
  '',
33
33
  ' Docs: https://vike.io/data/',
34
34
  ' API key: https://vike.io/account?tab=api-keys',
@@ -38,12 +38,12 @@ Hard rules — agents that violate these produce wrong answers. Read once, apply
38
38
  Follow this decision tree **before every session**. Do not skip to Step 2 until auth is confirmed.
39
39
 
40
40
  ```
41
- 1. Is the `vike` CLI installed? (`vike --version`)
41
+ 1. Is the `vike` CLI installed? (`vike-data --version`)
42
42
  ├── YES → continue
43
43
  └── NO → `npm install -g @vike-io/cli`
44
44
 
45
- 2. Is $VIKE_API_KEY set OR has the user run `vike init` / `vike login` already?
46
- ├── YES → run `vike doctor` to verify the key + endpoint reachability. Proceed.
45
+ 2. Is $VIKE_API_KEY set OR has the user run `vike-data init` / `vike-data login` already?
46
+ ├── YES → run `vike-data doctor` to verify the key + endpoint reachability. Proceed.
47
47
  └── NO → prompt the user (see Setup below).
48
48
  ```
49
49
 
@@ -54,8 +54,8 @@ If the user has no API key yet, tell them:
54
54
  > **To use vike, you'll need a free API key:**
55
55
  >
56
56
  > 1. Visit https://vike.io/account?tab=api-keys&utm_source=skill&utm_medium=ai&utm_campaign=cli_skill, sign in, and copy a key (starts with `vk_`).
57
- > 2. Save it: `vike login --api-key vk_...` (or `export VIKE_API_KEY=vk_...`).
58
- > 3. Verify: `vike doctor`.
57
+ > 2. Save it: `vike-data login --api-key vk_...` (or `export VIKE_API_KEY=vk_...`).
58
+ > 3. Verify: `vike-data doctor`.
59
59
  >
60
60
  > Per-key default cap: 2000 requests/hour. Most calls return in <500ms.
61
61
 
@@ -70,33 +70,33 @@ X-API-KEY: vk_...
70
70
 
71
71
  | User is asking about... | Service | CLI / Tool |
72
72
  |---|---|---|
73
- | Token by symbol/name → address, market cap, holders | **Tokens** | `vike token search` / `token_search` |
74
- | Token holders, who bought/sold, top inflows | **Tokens** | `vike token transfers` / `token_transfers` |
75
- | Filter/screen tokens by smart-money flow, liquidity, age | **Tokens** | `vike token screener` / `token_screener` |
76
- | Single wallet's PnL, holdings, recent activity | **Wallets** | `vike wallet summary` / `wallet_summary` |
77
- | Top wallets by PnL on a token / leaderboard | **Wallets** | `vike wallet discover` / `wallet_discover` |
78
- | Recent wallet transactions with USD values | **Wallets** | `vike wallet transactions` / `wallet_transactions` |
79
- | Compare 2+ wallets side by side | **Wallets** | `vike wallet compare` / `wallet_compare` |
80
- | Trace funds N hops from a starting wallet | **Wallets** | `vike wallet trace` / `wallet_trace` |
81
- | Find counterparties (who sends to / receives from) | **Wallets** | `vike wallet counterparties` / `wallet_counterparties` |
82
- | Wallet PnL history (timeseries) | **Wallets** | `vike wallet pnl-history` / `wallet_pnl_history` |
83
- | Token balances for a wallet | **Wallets** | `vike wallet balances` / `wallet_token_balances` |
84
- | ENS name → address or address → ENS | **Wallets** | `vike wallet ens` / `wallet_ens` |
85
- | Bulk-label many wallets at once | **Wallets** | `vike wallet batch` / `wallet_batch_labels` |
86
- | Why is this wallet labeled X? (provenance) | **Labels** | `vike labels provenance` / `wallet_label_provenance` |
87
- | Funding rates across CEX perps (Binance/Bybit/OKX/Aster/HL) | **CEX Perps** | `vike perp funding` / `perp_funding` |
88
- | Price spreads of same symbol across CEX perp venues | **CEX Perps** | `vike perp spreads` / `perp_spreads` |
89
- | Top Hyperliquid perp traders by PnL / volume | **HL Perps** | `vike perp top-traders` / `hl_perp_top_traders` |
90
- | Reverse-lookup an HL share card → which wallet holds it | **HL Perps** | `vike perp find-position` / `hl_position_match` |
91
- | Historical candles for a Hyperliquid perp or spot market (1m–1d) | **Candles** | `vike candles hl <symbol>` / `hl_ohlcv` |
92
- | Historical probability candles for a Polymarket outcome token | **Candles** | `vike candles polymarket <token_id>` / `polymarket_ohlcv` |
93
- | Active Polymarket markets, volume, odds | **Polymarket** | `vike polymarket markets` / `polymarket_markets` |
94
- | Single Polymarket market detail | **Polymarket** | `vike polymarket detail` / `polymarket_market_detail` |
95
- | Polymarket trader profile / positions | **Polymarket** | `vike polymarket wallet` / `polymarket_wallet` |
96
- | Best-performing Polymarket traders | **Polymarket** | `vike polymarket smart-money` / `polymarket_smart_money` |
97
- | Create / list / edit price-or-flow alerts | **Alerts** | `vike alerts ...` / `alerts_*` |
98
-
99
- **When in doubt, start with `vike token search` or `vike wallet summary`** — both are cheap, return instantly, and disambiguate what the user actually meant.
73
+ | Token by symbol/name → address, market cap, holders | **Tokens** | `vike-data token search` / `token_search` |
74
+ | Token holders, who bought/sold, top inflows | **Tokens** | `vike-data token transfers` / `token_transfers` |
75
+ | Filter/screen tokens by smart-money flow, liquidity, age | **Tokens** | `vike-data token screener` / `token_screener` |
76
+ | Single wallet's PnL, holdings, recent activity | **Wallets** | `vike-data wallet summary` / `wallet_summary` |
77
+ | Top wallets by PnL on a token / leaderboard | **Wallets** | `vike-data wallet discover` / `wallet_discover` |
78
+ | Recent wallet transactions with USD values | **Wallets** | `vike-data wallet transactions` / `wallet_transactions` |
79
+ | Compare 2+ wallets side by side | **Wallets** | `vike-data wallet compare` / `wallet_compare` |
80
+ | Trace funds N hops from a starting wallet | **Wallets** | `vike-data wallet trace` / `wallet_trace` |
81
+ | Find counterparties (who sends to / receives from) | **Wallets** | `vike-data wallet counterparties` / `wallet_counterparties` |
82
+ | Wallet PnL history (timeseries) | **Wallets** | `vike-data wallet pnl-history` / `wallet_pnl_history` |
83
+ | Token balances for a wallet | **Wallets** | `vike-data wallet balances` / `wallet_token_balances` |
84
+ | ENS name → address or address → ENS | **Wallets** | `vike-data wallet ens` / `wallet_ens` |
85
+ | Bulk-label many wallets at once | **Wallets** | `vike-data wallet batch` / `wallet_batch_labels` |
86
+ | Why is this wallet labeled X? (provenance) | **Labels** | `vike-data labels provenance` / `wallet_label_provenance` |
87
+ | Funding rates across CEX perps (Binance/Bybit/OKX/Aster/HL) | **CEX Perps** | `vike-data perp funding` / `perp_funding` |
88
+ | Price spreads of same symbol across CEX perp venues | **CEX Perps** | `vike-data perp spreads` / `perp_spreads` |
89
+ | Top Hyperliquid perp traders by PnL / volume | **HL Perps** | `vike-data perp top-traders` / `hl_perp_top_traders` |
90
+ | Reverse-lookup an HL share card → which wallet holds it | **HL Perps** | `vike-data perp find-position` / `hl_position_match` |
91
+ | Historical candles for a Hyperliquid perp or spot market (1m–1d) | **Candles** | `vike-data candles hl <symbol>` / `hl_ohlcv` |
92
+ | Historical probability candles for a Polymarket outcome token | **Candles** | `vike-data candles polymarket <token_id>` / `polymarket_ohlcv` |
93
+ | Active Polymarket markets, volume, odds | **Polymarket** | `vike-data polymarket markets` / `polymarket_markets` |
94
+ | Single Polymarket market detail | **Polymarket** | `vike-data polymarket detail` / `polymarket_market_detail` |
95
+ | Polymarket trader profile / positions | **Polymarket** | `vike-data polymarket wallet` / `polymarket_wallet` |
96
+ | Best-performing Polymarket traders | **Polymarket** | `vike-data polymarket smart-money` / `polymarket_smart_money` |
97
+ | Create / list / edit price-or-flow alerts | **Alerts** | `vike-data alerts ...` / `alerts_*` |
98
+
99
+ **When in doubt, start with `vike-data token search` or `vike-data wallet summary`** — both are cheap, return instantly, and disambiguate what the user actually meant.
100
100
 
101
101
  ### Example query routing
102
102
  ```
@@ -120,13 +120,13 @@ X-API-KEY: vk_...
120
120
 
121
121
  **A) Via CLI (recommended for shell-bound agents).** All commands accept `--json` for machine-readable output:
122
122
  ```bash
123
- vike wallet summary 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json
124
- vike perp funding --symbol BTC --window 24h --json
123
+ vike-data wallet summary 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json
124
+ vike-data perp funding --symbol BTC --window 24h --json
125
125
  ```
126
126
 
127
127
  **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`.
128
128
 
129
- 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.
129
+ Run `vike-data 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.
130
130
 
131
131
  ---
132
132
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-alerts-setup
3
3
  description: Create, list, edit, and delete on-chain transfer alerts. Alerts fire when a token transfer crosses USD thresholds you set and deliver to email or Discord. Use when the user asks "alert me when X" / "watch for big transfers" / "notify on whale moves".
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-alerts-setup
@@ -9,7 +9,7 @@ allowed-tools: Bash(vike:*)
9
9
  ## Pre-check: what channels does the user have set up?
10
10
 
11
11
  ```bash
12
- vike alerts channels --json
12
+ vike-data alerts channels --json
13
13
  ```
14
14
 
15
15
  Returns enabled email + Discord channels. **If a user creates an alert with a channel they haven't verified, the alert is saved but won't fire notifications.** Always check first.
@@ -19,14 +19,14 @@ Returns enabled email + Discord channels. **If a user creates an alert with a ch
19
19
  ### List
20
20
 
21
21
  ```bash
22
- vike alerts list --json # active alerts
23
- vike alerts list --include-inactive --json # also paused/deleted
22
+ vike-data alerts list --json # active alerts
23
+ vike-data alerts list --include-inactive --json # also paused/deleted
24
24
  ```
25
25
 
26
26
  ### Create
27
27
 
28
28
  ```bash
29
- vike alerts create \
29
+ vike-data alerts create \
30
30
  --label "Big USDC moves" \
31
31
  --token USDC \
32
32
  --chain eth \
@@ -40,16 +40,16 @@ Required: `--label`. Common: `--token`, `--chain eth|bsc`, `--min-usd`, `--chann
40
40
  ### Edit (partial update — only fields you pass are changed)
41
41
 
42
42
  ```bash
43
- vike alerts edit 42 --min-usd 5000000 # raise threshold
44
- vike alerts edit 42 --active false # pause
45
- vike alerts edit 42 --channel email --channel discord # add second channel
43
+ vike-data alerts edit 42 --min-usd 5000000 # raise threshold
44
+ vike-data alerts edit 42 --active false # pause
45
+ vike-data alerts edit 42 --channel email --channel discord # add second channel
46
46
  ```
47
47
 
48
48
  ### Delete
49
49
 
50
50
  ```bash
51
- vike alerts delete 42 # soft-delete (pauses, keeps history)
52
- vike alerts delete 42 --hard # permanently remove
51
+ vike-data alerts delete 42 # soft-delete (pauses, keeps history)
52
+ vike-data alerts delete 42 --hard # permanently remove
53
53
  ```
54
54
 
55
55
  ## Notes + gotchas
@@ -58,7 +58,7 @@ vike alerts delete 42 --hard # permanently remove
58
58
  - Thresholds are in **USD value** of the transfer at fire time, not token quantity.
59
59
  - `--cooldown` is per-alert minimum gap between triggers (default 60 min). Useful to avoid spam during high-volume hours.
60
60
  - Tokens are matched by symbol (UPPERCASE). For cross-chain symbols like `USDC` that exist on multiple chains, be explicit with `--chain`.
61
- - Alerts created without a verified channel will be **silently inactive at fire time** — there is no automatic warning. Use `vike alerts channels` first.
61
+ - Alerts created without a verified channel will be **silently inactive at fire time** — there is no automatic warning. Use `vike-data alerts channels` first.
62
62
 
63
63
  ## Confirmation flow with the user
64
64
 
@@ -66,7 +66,7 @@ Before creating an alert, summarize back what will be created:
66
66
 
67
67
  > Creating alert "**Big USDC moves**": will fire when a USDC transfer on **eth** exceeds **$1M**, delivered via **email**, with a 60-minute cooldown. OK to proceed?
68
68
 
69
- Wait for confirmation, then run `vike alerts create`.
69
+ Wait for confirmation, then run `vike-data alerts create`.
70
70
 
71
71
  ## Anti-patterns
72
72
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-alerts-webhook
3
3
  description: Register an HTTPS webhook as an alert delivery channel — get HMAC-signed POST notifications when alerts fire. Use when the user has a server / bot / Slack integration and wants programmatic alert delivery instead of email/Discord.
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-alerts-webhook
@@ -9,7 +9,7 @@ allowed-tools: Bash(vike:*)
9
9
  ## Registration
10
10
 
11
11
  ```bash
12
- vike alerts register-webhook <https://your-server.com/vike-hook>
12
+ vike-data alerts register-webhook <https://your-server.com/vike-hook>
13
13
  [--secret <16+ char HMAC secret>]
14
14
  [--json]
15
15
  ```
@@ -23,7 +23,7 @@ The secret is **optional but strongly recommended** — without it we still POST
23
23
  openssl rand -hex 32
24
24
  # → 7f5c8b... (paste below)
25
25
 
26
- vike alerts register-webhook https://api.mycoolbot.com/vike-alert \
26
+ vike-data alerts register-webhook https://api.mycoolbot.com/vike-alert \
27
27
  --secret 7f5c8b... \
28
28
  --json
29
29
  # → { "ok": true, "channel_id": 42, "url_preview": "https://api.myc...", "signed": true }
@@ -80,5 +80,5 @@ def verify(secret, headers, body):
80
80
 
81
81
  ## Pairs well with
82
82
 
83
- - `vike alerts create` — create the alert that fires to your webhook
84
- - `vike alerts list` / `vike alerts channels` — confirm registration
83
+ - `vike-data alerts create` — create the alert that fires to your webhook
84
+ - `vike-data alerts list` / `vike-data alerts channels` — confirm registration
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-candles
3
3
  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).
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-candles
@@ -15,7 +15,7 @@ rather than guessing a venue.
15
15
  Hyperliquid (perp or spot), built from HL's own executed fills:
16
16
 
17
17
  ```bash
18
- vike candles hl <symbol>
18
+ vike-data candles hl <symbol>
19
19
  [--interval 1m|5m|15m|30m|1h|4h|1d] # default 1h
20
20
  [--market perp|spot] # default perp
21
21
  [--dex <name>] # HIP-3 builder DEX; default HL (the core venue)
@@ -27,7 +27,7 @@ vike candles hl <symbol>
27
27
  Polymarket, ONE outcome token (a probability, 0-1):
28
28
 
29
29
  ```bash
30
- vike candles polymarket <token_id>
30
+ vike-data candles polymarket <token_id>
31
31
  [--interval 1m|5m|1h|1d] # default 1h
32
32
  [--from <epoch-ms>] [--to <epoch-ms>] # both inclusive
33
33
  [--limit N] # default 500, max 1000
@@ -38,10 +38,10 @@ vike candles polymarket <token_id>
38
38
 
39
39
  | Question | Command |
40
40
  |---|---|
41
- | "Hourly BTC perp candles, last week" | `vike candles hl BTC --interval 1h --limit 168` |
42
- | "HYPE spot daily candles" | `vike candles hl HYPE --market spot --interval 1d` |
43
- | "4h ETH, 200 bars" | `vike candles hl ETH --interval 4h --limit 200` |
44
- | "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` |
41
+ | "Hourly BTC perp candles, last week" | `vike-data candles hl BTC --interval 1h --limit 168` |
42
+ | "HYPE spot daily candles" | `vike-data candles hl HYPE --market spot --interval 1d` |
43
+ | "4h ETH, 200 bars" | `vike-data candles hl ETH --interval 4h --limit 200` |
44
+ | "Price history of the YES outcome of market X" | get `clob_token_ids` from `vike-data polymarket market <condition_id>`, then `vike-data candles polymarket <token_id> --interval 1h` |
45
45
 
46
46
  ## Output
47
47
 
@@ -50,12 +50,12 @@ Polymarket: `ts`, `open`, `high`, `low`, `close`, `volume`, `trades`, oldest fir
50
50
 
51
51
  ## Pitfalls
52
52
 
53
- - 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`.
53
+ - 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-data polymarket market`.
54
54
  - Polymarket has no cursor: a window wider than `--limit` is truncated at the **old** end. Raise `--from` to reach the recent end.
55
55
  - Polymarket `--from` / `--to` are epoch **milliseconds**; HL `--start` / `--end` also accept ISO-8601.
56
56
  - HL buckets are left-aligned UTC and the window is half-open.
57
57
 
58
58
  ## Pairs well with
59
59
 
60
- - `vike polymarket market <condition_id>` — to find the token ids
61
- - `vike perp top-traders` — who is trading the asset behind the candles
60
+ - `vike-data polymarket market <condition_id>` — to find the token ids
61
+ - `vike-data perp top-traders` — who is trading the asset behind the candles
@@ -1,17 +1,17 @@
1
1
  ---
2
2
  name: vike-core
3
- description: Install-first skill — authentication, setup, and CLI conventions for the vike toolkit. Use when you see any `vike <cmd>` reference or the user mentions on-chain analytics, Hyperliquid perps, options flow, or prediction markets.
3
+ description: Install-first skill — authentication, setup, and CLI conventions for the vike toolkit. Use when you see any `vike-data <cmd>` reference or the user mentions on-chain analytics, Hyperliquid perps, options flow, or prediction markets.
4
4
  metadata:
5
5
  openclaw:
6
6
  requires:
7
7
  env: [VIKE_API_KEY]
8
- bins: [vike]
8
+ bins: [vike-data]
9
9
  primaryEnv: VIKE_API_KEY
10
10
  install:
11
11
  - kind: node
12
12
  package: "@vike-io/cli"
13
- bins: [vike]
14
- allowed-tools: Bash(vike:*)
13
+ bins: [vike-data]
14
+ allowed-tools: Bash(vike-data:*)
15
15
  ---
16
16
 
17
17
  # vike-core
@@ -27,8 +27,8 @@ npm install -g @vike-io/cli
27
27
  ## Authenticate (one of these)
28
28
 
29
29
  ```bash
30
- vike init # interactive: prompt for API key + verify
31
- vike login --api-key vk_... # non-interactive
30
+ vike-data init # interactive: prompt for API key + verify
31
+ vike-data login --api-key vk_... # non-interactive
32
32
  export VIKE_API_KEY=vk_... # env (wins over saved config)
33
33
  ```
34
34
 
@@ -37,9 +37,9 @@ Get an API key at https://vike.io/account?tab=api-keys
37
37
  ## Verify
38
38
 
39
39
  ```bash
40
- vike doctor # Node version + API key + endpoint reachability + tool count
41
- vike whoami # which key is in use (masked)
42
- vike schema --pretty # full command list with flags
40
+ vike-data doctor # Node version + API key + endpoint reachability + tool count
41
+ vike-data whoami # which key is in use (masked)
42
+ vike-data schema --pretty # full command list with flags
43
43
  ```
44
44
 
45
45
  ## Conventions
@@ -48,13 +48,13 @@ vike schema --pretty # full command list with flags
48
48
  - Addresses: pass full 0x-prefixed hex (42 chars). Never truncate when reporting back to the user.
49
49
  - USD amounts: integers/decimals (e.g. `--min-usd 10000`).
50
50
  - Chain identifiers: `eth`, `bsc`, `base`, `arb`, `hyper`, `btc`, `sol`, `tron`, `xmr`, `zec`, `dash` (depending on the command — some only support a subset).
51
- - Time windows: `24h`, `7d`, `30d`, `90d`, `all` (per command; check `vike <cmd> --help`).
51
+ - Time windows: `24h`, `7d`, `30d`, `90d`, `all` (per command; check `vike-data <cmd> --help`).
52
52
 
53
53
  ## Errors
54
54
 
55
- - `No API key` → run `vike init` or set `VIKE_API_KEY`.
55
+ - `No API key` → run `vike-data init` or set `VIKE_API_KEY`.
56
56
  - `MCP error -32000: Hourly rate limit exceeded` → you hit the per-key cap; wait or upgrade your plan.
57
- - `Network error` / timeout → check `vike doctor`; the endpoint is `https://vike.io/mcp`.
57
+ - `Network error` / timeout → check `vike-data doctor`; the endpoint is `https://vike.io/mcp`.
58
58
  - `503` from a tool → upstream data source temporarily down; retry in 30s.
59
59
 
60
60
  ## Cost awareness
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-cross-venue-perps
3
3
  description: Compare a single perp symbol across all venues — funding, price, spreads. Use when the user asks "where to trade X" / "compare BTC perp across exchanges" / "best venue for ETH long".
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-cross-venue-perps
@@ -12,11 +12,11 @@ Per-symbol cross-venue analysis.
12
12
 
13
13
  1. Per-venue funding
14
14
  ```bash
15
- vike perp funding --symbol <SYM> --json
15
+ vike-data perp funding --symbol <SYM> --json
16
16
  ```
17
17
  2. Per-venue spread
18
18
  ```bash
19
- vike perp spreads --symbol <SYM> --json
19
+ vike-data perp spreads --symbol <SYM> --json
20
20
  ```
21
21
 
22
22
  ## Report template
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-hl-position-match
3
3
  description: Reverse-lookup a Hyperliquid open position from share-card details (coin + side + leverage + entry price). Use when the user pastes or describes a HL share card and asks "whose card is this?", "find this trader", or "who has a 25x ETH long open at $3,200?". Returns matching wallet(s) ranked by entry-price proximity.
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-hl-position-match
@@ -11,7 +11,7 @@ Find the wallet(s) holding an open Hyperliquid perp position that match a share
11
11
  ## Command
12
12
 
13
13
  ```bash
14
- vike perp find-position
14
+ vike-data perp find-position
15
15
  --coin <SYM> # e.g. BTC, ETH, SOL
16
16
  --side long|short
17
17
  --leverage <X> # e.g. 25
@@ -77,7 +77,7 @@ The response includes `tolerance_used` so the caller knows which band matched (`
77
77
 
78
78
  - Don't fabricate matches when the tool returns `match_count: 0`. Say "no open position matches that share card" — closed positions, post-card adds, or non-HL cards all produce empty results.
79
79
  - Don't strip the address when displaying — share-card investigations always want the full 0x...40hex (users copy-paste it).
80
- - Don't infer trader skill from a single share-card match. Use `vike perp top-traders` or `vike wallet summary` for profile context.
80
+ - Don't infer trader skill from a single share-card match. Use `vike-data perp top-traders` or `vike-data wallet summary` for profile context.
81
81
 
82
82
  ## Pairs well with
83
83
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-hl-top-traders
3
3
  description: Rank top Hyperliquid perp traders by PnL / ROI / win rate / volume / trade count / drawdown across a window. Use when the user asks "top HL traders" / "best Hyperliquid wallets" / "HL leaderboard".
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-hl-top-traders
@@ -9,7 +9,7 @@ allowed-tools: Bash(vike:*)
9
9
  ## Command
10
10
 
11
11
  ```bash
12
- vike perp top-traders
12
+ vike-data perp top-traders
13
13
  [--window 1d|7d|30d|all]
14
14
  [--sort pnl|roi|win_rate|volume|trade_count|drawdown]
15
15
  [--order asc|desc]
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-hl-trader-profile
3
3
  description: Profile a single Hyperliquid perp trader — leaderboard rank, recent performance, on-chain identity. Use when the user gives an HL wallet address and asks "is this trader any good" / "profile this address" / "what's this wallet's HL track record".
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-hl-trader-profile
@@ -13,7 +13,7 @@ Composite profile combining ranking, identity, and trading metrics.
13
13
  ### 1. On-chain identity + balance
14
14
 
15
15
  ```bash
16
- vike wallet summary <address> --json
16
+ vike-data wallet summary <address> --json
17
17
  ```
18
18
 
19
19
  Captures: total volume, inflow/outflow, tx count, unique tokens across ETH/BSC/Base. Tells you if the address is HL-only or also active on spot chains.
@@ -21,8 +21,8 @@ Captures: total volume, inflow/outflow, tx count, unique tokens across ETH/BSC/B
21
21
  ### 2. HL leaderboard rank
22
22
 
23
23
  ```bash
24
- vike perp top-traders --window 30d --sort pnl --size 20 --json
25
- vike perp top-traders --window 7d --sort pnl --size 20 --json
24
+ vike-data perp top-traders --window 30d --sort pnl --size 20 --json
25
+ vike-data perp top-traders --window 7d --sort pnl --size 20 --json
26
26
  ```
27
27
 
28
28
  Search the returned rows for the address. Report rank if found, "outside top 20" otherwise.
@@ -30,8 +30,8 @@ Search the returned rows for the address. Report rank if found, "outside top 20"
30
30
  ### 3. ROI + win rate context
31
31
 
32
32
  ```bash
33
- vike perp top-traders --sort roi --window 30d --min-trades 10 --size 20 --json
34
- vike perp top-traders --sort win_rate --window 30d --min-trades 10 --size 20 --json
33
+ vike-data perp top-traders --sort roi --window 30d --min-trades 10 --size 20 --json
34
+ vike-data perp top-traders --sort win_rate --window 30d --min-trades 10 --size 20 --json
35
35
  ```
36
36
 
37
37
  Same address-search; report rank or "not in top 20".
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: vike-perp-funding-arb
3
3
  description: Find cross-venue funding-rate arbitrage opportunities on perpetual futures. Use when the user asks "any funding arb today" / "where to long-short X for funding" / "highest funding rates".
4
- allowed-tools: Bash(vike:*)
4
+ allowed-tools: Bash(vike-data:*)
5
5
  ---
6
6
 
7
7
  # vike-perp-funding-arb
@@ -13,7 +13,7 @@ Cross-venue funding rates across Binance, Bybit, OKX, Aster, and Hyperliquid.
13
13
  ### A. All arb opportunities (default)
14
14
 
15
15
  ```bash
16
- vike perp funding --json
16
+ vike-data perp funding --json
17
17
  ```
18
18
 
19
19
  Returns pre-ranked rows where the spread between the highest-funding venue and the lowest is ≥ 0.3% (daily normalized). Each row already includes:
@@ -27,7 +27,7 @@ Returns pre-ranked rows where the spread between the highest-funding venue and t
27
27
  ### B. Single symbol per-venue rates
28
28
 
29
29
  ```bash
30
- vike perp funding --symbol BTC --json
30
+ vike-data perp funding --symbol BTC --json
31
31
  ```
32
32
 
33
33
  Returns one row per venue: `{exchange, funding_rate_daily_pct, mark_price, ...}`.
@@ -39,7 +39,7 @@ spread_daily_pct = 0.42% → ~$420/day per $100k notional, gross
39
39
  (before fees, slippage, transfer costs)
40
40
  ```
41
41
 
42
- A funding arb at 0.4–1% daily is real. > 3% daily on a liquid pair is almost always a halted-trading / venue-mispricing artifact — verify with `vike perp spreads --symbol <sym>` to make sure the underlying spot/perp prices are sane.
42
+ A funding arb at 0.4–1% daily is real. > 3% daily on a liquid pair is almost always a halted-trading / venue-mispricing artifact — verify with `vike-data perp spreads --symbol <sym>` to make sure the underlying spot/perp prices are sane.
43
43
 
44
44
  ## Anti-patterns
45
45