@vike-io/cli 0.12.0 → 0.13.0

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 (48) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +164 -62
  3. package/package.json +7 -6
  4. package/scripts/postinstall.js +5 -4
  5. package/skills/vike/SKILL.md +76 -85
  6. package/skills/vike-alerts-setup/SKILL.md +11 -11
  7. package/skills/vike-alerts-webhook/SKILL.md +4 -4
  8. package/skills/vike-candles/SKILL.md +9 -9
  9. package/skills/vike-core/SKILL.md +9 -9
  10. package/skills/vike-cross-venue-perps/SKILL.md +2 -2
  11. package/skills/vike-hl-position-match/SKILL.md +5 -5
  12. package/skills/vike-hl-top-traders/SKILL.md +1 -1
  13. package/skills/vike-hl-trader-profile/SKILL.md +5 -5
  14. package/skills/vike-perp-funding-arb/SKILL.md +3 -3
  15. package/skills/vike-perp-screener/SKILL.md +3 -3
  16. package/skills/vike-perp-spread-arb/SKILL.md +2 -2
  17. package/skills/vike-polymarket-market-detail/SKILL.md +4 -4
  18. package/skills/vike-polymarket-markets/SKILL.md +4 -4
  19. package/skills/vike-polymarket-screener/SKILL.md +3 -3
  20. package/skills/vike-polymarket-smart-money/SKILL.md +3 -3
  21. package/skills/vike-polymarket-trader/SKILL.md +3 -3
  22. package/skills/vike-router/SKILL.md +7 -7
  23. package/skills/vike-smart-money-discovery/SKILL.md +4 -4
  24. package/skills/vike-token-holders/SKILL.md +6 -6
  25. package/skills/vike-token-research/SKILL.md +3 -3
  26. package/skills/vike-token-screener/SKILL.md +7 -7
  27. package/skills/vike-token-search/SKILL.md +3 -3
  28. package/skills/vike-token-transfers/SKILL.md +3 -3
  29. package/skills/vike-wallet-balances/SKILL.md +5 -5
  30. package/skills/vike-wallet-batch/SKILL.md +5 -5
  31. package/skills/vike-wallet-compare/SKILL.md +4 -4
  32. package/skills/vike-wallet-counterparties/SKILL.md +6 -6
  33. package/skills/vike-wallet-discover/SKILL.md +3 -3
  34. package/skills/vike-wallet-ens/SKILL.md +5 -5
  35. package/skills/vike-wallet-label-provenance/SKILL.md +3 -3
  36. package/skills/vike-wallet-pnl-history/SKILL.md +4 -4
  37. package/skills/vike-wallet-portfolio/SKILL.md +5 -5
  38. package/skills/vike-wallet-summary/SKILL.md +4 -4
  39. package/skills/vike-wallet-trace/SKILL.md +5 -5
  40. package/skills/vike-wallet-transactions/SKILL.md +8 -8
  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 +2 -2
  45. package/src/commands/install.js +5 -5
  46. package/src/commands/labels.js +1 -1
  47. package/src/index.js +1 -1
  48. package/src/mcp-client.js +5 -6
@@ -5,11 +5,17 @@ description: "Use this skill whenever the user asks any question about on-chain
5
5
 
6
6
  # vike — Multi-chain On-chain Analytics
7
7
 
8
+ 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.
9
+
8
10
  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.
9
11
 
10
12
  **MCP endpoint for all calls:** `https://vike.io/mcp` (JSON-RPC 2.0)
11
13
  **Or use the CLI:** `npm install -g @vike-io/cli` → `vike <command>`
12
14
 
15
+ ## What it does and who it is for
16
+
17
+ 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.
18
+
13
19
  ---
14
20
 
15
21
  ## Critical Rules
@@ -32,12 +38,12 @@ Hard rules — agents that violate these produce wrong answers. Read once, apply
32
38
  Follow this decision tree **before every session**. Do not skip to Step 2 until auth is confirmed.
33
39
 
34
40
  ```
35
- 1. Is the `vike` CLI installed? (`vike --version`)
41
+ 1. Is the `vike` CLI installed? (`vike-data --version`)
36
42
  ├── YES → continue
37
43
  └── NO → `npm install -g @vike-io/cli`
38
44
 
39
- 2. Is $VIKE_API_KEY set OR has the user run `vike init` / `vike login` already?
40
- ├── 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.
41
47
  └── NO → prompt the user (see Setup below).
42
48
  ```
43
49
 
@@ -48,12 +54,12 @@ If the user has no API key yet, tell them:
48
54
  > **To use vike, you'll need a free API key:**
49
55
  >
50
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_`).
51
- > 2. Save it: `vike login --api-key vk_...` (or `export VIKE_API_KEY=vk_...`).
52
- > 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`.
53
59
  >
54
60
  > Per-key default cap: 2000 requests/hour. Most calls return in <500ms.
55
61
 
56
- If using the MCP server directly (without the CLI), send the key as a header:
62
+ If using the MCP server directly (without the CLI), authenticate with the key in this header:
57
63
  ```
58
64
  X-API-KEY: vk_...
59
65
  ```
@@ -64,33 +70,33 @@ X-API-KEY: vk_...
64
70
 
65
71
  | User is asking about... | Service | CLI / Tool |
66
72
  |---|---|---|
67
- | Token by symbol/name → address, market cap, holders | **Tokens** | `vike token search` / `token_search` |
68
- | Token holders, who bought/sold, top inflows | **Tokens** | `vike token transfers` / `token_transfers` |
69
- | Filter/screen tokens by smart-money flow, liquidity, age | **Tokens** | `vike token screener` / `token_screener` |
70
- | Single wallet's PnL, holdings, recent activity | **Wallets** | `vike wallet summary` / `wallet_summary` |
71
- | Top wallets by PnL on a token / leaderboard | **Wallets** | `vike wallet discover` / `wallet_discover` |
72
- | Recent wallet transactions with USD values | **Wallets** | `vike wallet transactions` / `wallet_transactions` |
73
- | Compare 2+ wallets side by side | **Wallets** | `vike wallet compare` / `wallet_compare` |
74
- | Trace funds N hops from a starting wallet | **Wallets** | `vike wallet trace` / `wallet_trace` |
75
- | Find counterparties (who sends to / receives from) | **Wallets** | `vike wallet counterparties` / `wallet_counterparties` |
76
- | Wallet PnL history (timeseries) | **Wallets** | `vike wallet pnl-history` / `wallet_pnl_history` |
77
- | Token balances for a wallet | **Wallets** | `vike wallet balances` / `wallet_token_balances` |
78
- | ENS name → address or address → ENS | **Wallets** | `vike wallet ens` / `wallet_ens` |
79
- | Bulk-label many wallets at once | **Wallets** | `vike wallet batch` / `wallet_batch_labels` |
80
- | Why is this wallet labeled X? (provenance) | **Labels** | `vike labels provenance` / `wallet_label_provenance` |
81
- | Funding rates across CEX perps (Binance/Bybit/OKX/Aster/HL) | **CEX Perps** | `vike perp funding` / `perp_funding` |
82
- | Price spreads of same symbol across CEX perp venues | **CEX Perps** | `vike perp spreads` / `perp_spreads` |
83
- | Top Hyperliquid perp traders by PnL / volume | **HL Perps** | `vike perp top-traders` / `hl_perp_top_traders` |
84
- | Reverse-lookup an HL share card → which wallet holds it | **HL Perps** | `vike perp find-position` / `hl_position_match` |
85
- | Historical candles for a Hyperliquid perp or spot market (1m–1d) | **Candles** | `vike candles hl <symbol>` / `hl_ohlcv` |
86
- | Historical probability candles for a Polymarket outcome token | **Candles** | `vike candles polymarket <token_id>` / `polymarket_ohlcv` |
87
- | Active Polymarket markets, volume, odds | **Polymarket** | `vike polymarket markets` / `polymarket_markets` |
88
- | Single Polymarket market detail | **Polymarket** | `vike polymarket detail` / `polymarket_market_detail` |
89
- | Polymarket trader profile / positions | **Polymarket** | `vike polymarket wallet` / `polymarket_wallet` |
90
- | Best-performing Polymarket traders | **Polymarket** | `vike polymarket smart-money` / `polymarket_smart_money` |
91
- | Create / list / edit price-or-flow alerts | **Alerts** | `vike alerts ...` / `alerts_*` |
92
-
93
- **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.
94
100
 
95
101
  ### Example query routing
96
102
  ```
@@ -114,44 +120,29 @@ X-API-KEY: vk_...
114
120
 
115
121
  **A) Via CLI (recommended for shell-bound agents).** All commands accept `--json` for machine-readable output:
116
122
  ```bash
117
- vike wallet summary 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --json
118
- 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
119
125
  ```
120
126
 
121
- **B) Via MCP JSON-RPC (recommended when an MCP connector is available).** All 34 tools live at `https://vike.io/mcp`:
122
- ```http
123
- POST https://vike.io/mcp
124
- X-API-KEY: vk_...
125
- Content-Type: application/json
126
-
127
- {
128
- "jsonrpc": "2.0",
129
- "id": 1,
130
- "method": "tools/call",
131
- "params": {
132
- "name": "wallet_summary",
133
- "arguments": {"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum"}
134
- }
135
- }
136
- ```
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`.
137
128
 
138
- 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.
139
130
 
140
131
  ---
141
132
 
142
133
  ## Per-service tool reference
143
134
 
144
- 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).
135
+ 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`.
145
136
 
146
137
  ### Tokens
147
138
  Address resolution, transfers, holder cohorts, screening.
148
139
 
149
140
  | Tool | Description | Skill |
150
141
  |---|---|---|
151
- | `token_search` | Symbol/name → contract address + chain + market cap | [vike-token-search](skills/vike-token-search/SKILL.md) |
152
- | `token_transfers` | Recent transfers with USD values; supports `--min-usd`, time windows | [vike-token-transfers](skills/vike-token-transfers/SKILL.md) |
153
- | `token_holders` | Top holders + concentration metrics | [vike-token-holders](skills/vike-token-holders/SKILL.md) |
154
- | `token_screener` | Filter tokens by smart-money inflow, age, liquidity, sector | [vike-token-screener](skills/vike-token-screener/SKILL.md) |
142
+ | `token_search` | Symbol/name → contract address + chain + market cap | `vike-token-search` |
143
+ | `token_transfers` | Recent transfers with USD values; supports `--min-usd`, time windows | `vike-token-transfers` |
144
+ | `token_holders` | Top holders + concentration metrics | `vike-token-holders` |
145
+ | `token_screener` | Filter tokens by smart-money inflow, age, liquidity, sector | `vike-token-screener` |
155
146
 
156
147
  **Key chains:** `ethereum`, `bsc`, `base`, `arbitrum`, `hyperevm` (EVM); `bitcoin`, `solana`, `tron`, `xmr`, `zec`, `dash` (non-EVM, limited tool support).
157
148
 
@@ -162,16 +153,16 @@ Profile, PnL, transactions, comparison, tracing, counterparty graph.
162
153
 
163
154
  | Tool | Description | Skill |
164
155
  |---|---|---|
165
- | `wallet_summary` | One-call profile: PnL, top holdings, recent activity, labels | [vike-wallet-summary](skills/vike-wallet-summary/SKILL.md) |
166
- | `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) |
167
- | `wallet_transactions` | Raw recent transactions (tx_hash, ts, from, to, token, usd) | [vike-wallet-transactions](skills/vike-wallet-transactions/SKILL.md) |
168
- | `wallet_compare` | Side-by-side metrics for 2+ wallets | [vike-wallet-compare](skills/vike-wallet-compare/SKILL.md) |
169
- | `wallet_trace` | BFS funds tracing N hops from a starting wallet | [vike-wallet-trace](skills/vike-wallet-trace/SKILL.md) |
170
- | `wallet_counterparties` | Top counterparties (who they send to / receive from) | [vike-wallet-counterparties](skills/vike-wallet-counterparties/SKILL.md) |
171
- | `wallet_pnl_history` | Daily PnL timeseries over `--days N` | [vike-wallet-pnl-history](skills/vike-wallet-pnl-history/SKILL.md) |
172
- | `wallet_token_balances` | Current token balances (Moralis-backed) | [vike-wallet-balances](skills/vike-wallet-balances/SKILL.md) |
173
- | `wallet_ens` | ENS name ↔ address (local cache: 477K wallets pre-resolved) | [vike-wallet-ens](skills/vike-wallet-ens/SKILL.md) |
174
- | `wallet_batch_labels` | Bulk-label up to 100 addresses in one call | [vike-wallet-batch](skills/vike-wallet-batch/SKILL.md) |
156
+ | `wallet_summary` | One-call profile: PnL, top holdings, recent activity, labels | `vike-wallet-summary` |
157
+ | `wallet_discover` | Leaderboard of top wallets by PnL/inflow on a token | `vike-wallet-discover`, `vike-smart-money-discovery` |
158
+ | `wallet_transactions` | Raw recent transactions (tx_hash, ts, from, to, token, usd) | `vike-wallet-transactions` |
159
+ | `wallet_compare` | Side-by-side metrics for 2+ wallets | `vike-wallet-compare` |
160
+ | `wallet_trace` | BFS funds tracing N hops from a starting wallet | `vike-wallet-trace` |
161
+ | `wallet_counterparties` | Top counterparties (who they send to / receive from) | `vike-wallet-counterparties` |
162
+ | `wallet_pnl_history` | Daily PnL timeseries over `--days N` | `vike-wallet-pnl-history` |
163
+ | `wallet_token_balances` | Current token balances (Moralis-backed) | `vike-wallet-balances` |
164
+ | `wallet_ens` | ENS name ↔ address (local cache: 477K wallets pre-resolved) | `vike-wallet-ens` |
165
+ | `wallet_batch_labels` | Bulk-label up to 100 addresses in one call | `vike-wallet-batch` |
175
166
 
176
167
  **Address shape:** always full 0x-prefixed hex (42 chars). Never truncate when reporting back to the user.
177
168
 
@@ -182,7 +173,7 @@ Wallet label provenance.
182
173
 
183
174
  | Tool | Description | Skill |
184
175
  |---|---|---|
185
- | `wallet_label_provenance` | Why a wallet got a given label (sources + confidence) | [vike-wallet-label-provenance](skills/vike-wallet-label-provenance/SKILL.md) |
176
+ | `wallet_label_provenance` | Why a wallet got a given label (sources + confidence) | `vike-wallet-label-provenance` |
186
177
 
187
178
  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.
188
179
 
@@ -193,8 +184,8 @@ Vike's label cascade is multi-source — when an answer hinges on "is this reall
193
184
 
194
185
  | Tool | Description | Skill |
195
186
  |---|---|---|
196
- | `perp_funding` | Funding rates per symbol per venue + 24h/7d averages | [vike-perp-funding-arb](skills/vike-perp-funding-arb/SKILL.md) |
197
- | `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) |
187
+ | `perp_funding` | Funding rates per symbol per venue + 24h/7d averages | `vike-perp-funding-arb` |
188
+ | `perp_spreads` | Mark-price spreads of the same symbol across venues | `vike-perp-spread-arb`, `vike-cross-venue-perps` |
198
189
 
199
190
  ---
200
191
 
@@ -203,10 +194,10 @@ On-chain perps data: snapshots, fills, ledger, funding, attribution.
203
194
 
204
195
  | Tool | Description | Skill |
205
196
  |---|---|---|
206
- | `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) |
207
- | `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) |
197
+ | `hl_perp_top_traders` | Top HL traders by PnL/volume over a window | `vike-hl-top-traders`, `vike-hl-trader-profile` |
198
+ | `hl_position_match` | Reverse-lookup: share-card details (coin/side/lev/entry) → wallet holding that open position | `vike-hl-position-match` |
208
199
 
209
- 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).
200
+ For per-symbol HL screening / individual trader deep-dive, use `vike-perp-screener` and `vike-hl-trader-profile`.
210
201
 
211
202
  ---
212
203
 
@@ -215,8 +206,8 @@ Historical OHLCV from venues whose data is on-chain.
215
206
 
216
207
  | Tool | Description | Skill |
217
208
  |---|---|---|
218
- | `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) |
219
- | `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) |
209
+ | `hl_ohlcv` | Hyperliquid perp or spot candles, 1m–1d, built from HL's own executed fills (also HIP-3 builder DEXs) | `vike-candles` |
210
+ | `polymarket_ohlcv` | Candles for ONE Polymarket outcome token (price = probability, 0–1); needs `token_id`, not a condition_id | `vike-candles` |
220
211
 
221
212
  ---
222
213
 
@@ -225,10 +216,10 @@ Prediction markets — markets, traders, smart-money.
225
216
 
226
217
  | Tool | Description | Skill |
227
218
  |---|---|---|
228
- | `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) |
229
- | `polymarket_market_detail` | Single market: outcomes, holders, recent trades, time-to-resolution | [vike-polymarket-market-detail](skills/vike-polymarket-market-detail/SKILL.md) |
230
- | `polymarket_wallet` | One trader's positions, PnL, win rate | [vike-polymarket-trader](skills/vike-polymarket-trader/SKILL.md) |
231
- | `polymarket_smart_money` | Top-PnL Polymarket traders + their current open positions | [vike-polymarket-smart-money](skills/vike-polymarket-smart-money/SKILL.md) |
219
+ | `polymarket_markets` | Active markets sorted by volume / liquidity / volatility | `vike-polymarket-markets`, `vike-polymarket-screener` |
220
+ | `polymarket_market_detail` | Single market: outcomes, holders, recent trades, time-to-resolution | `vike-polymarket-market-detail` |
221
+ | `polymarket_wallet` | One trader's positions, PnL, win rate | `vike-polymarket-trader` |
222
+ | `polymarket_smart_money` | Top-PnL Polymarket traders + their current open positions | `vike-polymarket-smart-money` |
232
223
 
233
224
  ---
234
225
 
@@ -237,12 +228,12 @@ Create + manage alerts; deliver to email, Telegram, Discord, Webhook.
237
228
 
238
229
  | Tool | Description | Skill |
239
230
  |---|---|---|
240
- | `alerts_list` | List user's existing alerts | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
241
- | `alerts_create` | Create a new price/transfer/funding alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
242
- | `alerts_edit` | Edit an existing alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
243
- | `alerts_delete` | Delete an alert | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
244
- | `alerts_list_channels` | List user's registered delivery channels | [vike-alerts-setup](skills/vike-alerts-setup/SKILL.md) |
245
- | `alerts_register_webhook` | Register an HTTPS webhook (HMAC-signed deliveries) | [vike-alerts-webhook](skills/vike-alerts-webhook/SKILL.md) |
231
+ | `alerts_list` | List user's existing alerts | `vike-alerts-setup` |
232
+ | `alerts_create` | Create a new price/transfer/funding alert | `vike-alerts-setup` |
233
+ | `alerts_edit` | Edit an existing alert | `vike-alerts-setup` |
234
+ | `alerts_delete` | Delete an alert | `vike-alerts-setup` |
235
+ | `alerts_list_channels` | List user's registered delivery channels | `vike-alerts-setup` |
236
+ | `alerts_register_webhook` | Register an HTTPS webhook (HMAC-signed deliveries) | `vike-alerts-webhook` |
246
237
 
247
238
  Alerts fire on a 2-minute cron cycle (not streaming). Don't recommend WebSocket / push streaming — it's not how the platform works.
248
239
 
@@ -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
 
@@ -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
@@ -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,6 +1,6 @@
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:
@@ -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
@@ -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
@@ -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,10 +77,10 @@ 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
 
84
- - [vike-wallet-summary](../vike-wallet-summary/SKILL.md) — once you have the address, get the trader's HL profile + multi-chain identity.
85
- - [vike-hl-top-traders](../vike-hl-top-traders/SKILL.md) — check if the matched wallet is on a leaderboard.
86
- - [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.
84
+ - `vike-wallet-summary` — once you have the address, get the trader's HL profile + multi-chain identity.
85
+ - `vike-hl-top-traders` — check if the matched wallet is on a leaderboard.
86
+ - `vike-wallet-label-provenance` — find out if the wallet is a known CEX/fund/MM rather than a retail trader.
@@ -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]
@@ -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".
@@ -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
 
@@ -11,9 +11,9 @@ One-shot market overview for perpetuals.
11
11
  ## Workflow (3 parallel calls)
12
12
 
13
13
  ```bash
14
- vike perp funding --json & # top funding-arb opportunities
15
- vike perp spreads --json & # top spot-perp price spreads
16
- vike perp top-traders --window 1d --sort pnl --size 10 --json &
14
+ vike-data perp funding --json & # top funding-arb opportunities
15
+ vike-data perp spreads --json & # top spot-perp price spreads
16
+ vike-data perp top-traders --window 1d --sort pnl --size 10 --json &
17
17
  wait
18
18
  ```
19
19
 
@@ -9,8 +9,8 @@ allowed-tools: Bash(vike:*)
9
9
  ## Command
10
10
 
11
11
  ```bash
12
- vike perp spreads --json # full matrix, all symbols with spread >= 0.5%
13
- vike perp spreads --symbol BTC --json # one specific symbol
12
+ vike-data perp spreads --json # full matrix, all symbols with spread >= 0.5%
13
+ vike-data perp spreads --symbol BTC --json # one specific symbol
14
14
  ```
15
15
 
16
16
  ## Output
@@ -9,17 +9,17 @@ allowed-tools: Bash(vike:*)
9
9
  ## Command
10
10
 
11
11
  ```bash
12
- vike polymarket market <condition_id> [--json]
12
+ vike-data polymarket market <condition_id> [--json]
13
13
  ```
14
14
 
15
- `condition_id` is a hex string (you'll have it from `vike polymarket markets` output).
15
+ `condition_id` is a hex string (you'll have it from `vike-data polymarket markets` output).
16
16
 
17
17
  ## Example
18
18
 
19
19
  ```bash
20
- vike polymarket markets --category Crypto --limit 5 --json
20
+ vike-data polymarket markets --category Crypto --limit 5 --json
21
21
  # → pick a condition_id from the output, then:
22
- vike polymarket market 0x1234abcd...
22
+ vike-data polymarket market 0x1234abcd...
23
23
  ```
24
24
 
25
25
  ## What it returns