crypto-quant-signal-mcp 1.10.5 → 1.10.7

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.
package/README.md CHANGED
@@ -1,44 +1,75 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" />
2
+ <a href="https://algovault.com">
3
+ <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" />
4
+ </a>
3
5
  </p>
4
6
 
5
- # crypto-quant-signal-mcp
7
+ <h1 align="center">crypto-quant-signal-mcp</h1>
6
8
 
7
- The Brain Layer for AI Trading Agents — composite quant calls across 5 exchanges (Hyperliquid, Binance, Bybit, OKX, Bitget), cross-venue arbitrage detection, and regime-aware market classification via MCP. <!-- SNAPSHOT-LINE -->
8
-
9
- [![npm version](https://img.shields.io/npm/v/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
10
- [![npm downloads](https://img.shields.io/npm/dw/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
12
- [![On-Chain Verified](https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum)](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81)
9
+ <p align="center">
10
+ <strong>The Brain Layer for AI Trading Agents</strong><br/>
11
+ Composite quant trade calls · cross-venue funding arbitrage · regime-aware market classification<br/>
12
+ Across 5 exchanges (Hyperliquid · Binance · Bybit · OKX · Bitget) via MCP. <!-- SNAPSHOT-LINE -->
13
+ </p>
13
14
 
14
- **[Live Track Record](https://algovault.com/track-record)** — 89.4%+ PFE Win Rate across 60,000+ trade calls on 5 exchanges. Public, no login required. <!-- SNAPSHOT-LINE -->
15
+ <p align="center">
16
+ <a href="https://algovault.com"><strong>algovault.com</strong></a> ·
17
+ <a href="https://algovault.com/track-record"><strong>Live Track Record</strong></a> ·
18
+ <a href="https://api.algovault.com/signup"><strong>Sign Up</strong></a> ·
19
+ <a href="https://algovault.com/docs.html"><strong>Docs</strong></a>
20
+ </p>
15
21
 
16
- <!-- snapshot: 2026-04-28 — live source of truth: https://algovault.com/api/performance-public — refetch before citing exact numbers -->
22
+ <p align="center">
23
+ <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/v/crypto-quant-signal-mcp" alt="npm version" /></a>
24
+ <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/dw/crypto-quant-signal-mcp" alt="npm downloads" /></a>
25
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT" /></a>
26
+ <a href="https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81"><img src="https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum" alt="On-Chain Verified" /></a>
27
+ </p>
17
28
 
18
29
  ---
19
30
 
20
- ## What's new in v1.10.3
31
+ ## 📊 Live Track Record — Public, Verifiable, On-Chain
21
32
 
22
- Live since 2026-04-30:
33
+ <p align="center">
34
+ <a href="https://algovault.com/track-record">
35
+ <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/track-record-2026-05-06.png" alt="AlgoVault Live Track Record — 90.0% PFE Win Rate across 74,733 trade calls, 26 Merkle batches anchored on Base L2" width="100%" />
36
+ </a>
37
+ </p>
23
38
 
24
- - **Free tier unlocked** — every supported coin + every supported timeframe is now accessible at the free tier (was BTC/ETH only on 15m/1h). The 100-calls/month cap is the only ceiling. HOLD calls remain free at every tier. All 11 timeframes (`1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d`) are callable on demand — your first call for `SOL/4h` or `PEPE/15m` Just Works.
25
- - **`Connect Your MCP Client` docs section** — new walkthroughs for Claude Desktop, Cursor, Cline, Claude Code, Smithery, and plain HTTP/curl at [`algovault.com/docs.html#connect-mcp`](https://algovault.com/docs.html#connect-mcp). Every config snippet was web-verified against the upstream docs on 2026-04-30.
39
+ <p align="center">
40
+ <strong><span data-tr-field="pfe_wr">90.0%</span> PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">74,733</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">26</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">99%</span> HOLD rate</strong> <!-- SNAPSHOT-LINE -->
41
+ </p>
26
42
 
27
- > **Upgrading from v1.9.x or earlier?** MCP clients (Claude Desktop, Claude.ai custom connectors, Cursor, Cline) cache the tool list at session start. The free-tier behavior changed in v1.10.3 — even though no tool was renamed, **refresh your tool list** so the client picks up the new permissive responses:
28
- > - **Claude.ai / Claude Desktop**: Settings → Connectors → AlgoVault → toggle off + on (or click "Refresh tools")
29
- > - **Cursor / Cline**: restart the MCP server connection from the integration panel
30
- >
31
- > Cached tool responses from before the unlock may still surface "requires Starter" upgrade hints on free-tier calls. Refreshing fixes it instantly. (See the v1.10.0 entry below for the prior `signal → call` rename context, also subject to this same refresh recipe.)
43
+ <p align="center">
44
+ Every call is hashed at emission, anchored on Base L2 daily, and re-evaluated against actual price action. We can't edit history. <em>Refetch live numbers any time at <a href="https://algovault.com/track-record">algovault.com/track-record</a> or <a href="https://api.algovault.com/api/performance-public">/api/performance-public</a>.</em>
45
+ </p>
46
+
47
+ <p align="center">
48
+ <a href="https://algovault.com/track-record"><strong>→ Open the live dashboard</strong></a>
49
+ </p>
32
50
 
33
51
  ---
34
52
 
35
- ## What's new in v1.10.0
53
+ ## What's new in v1.10.7
36
54
 
37
- Live since 2026-04-28:
55
+ Live since 2026-05-06:
38
56
 
39
- - **`signal` → `call`** rename across the response shape, the tool name (`get_trade_call`), and the public dashboard. `get_trade_signal` is registered as an alias and continues to work for existing agents — no migration needed.
40
- - **`also_see` cross-asset leads** replace `try_next` with cells trimmed to `{coin, timeframe, confidence}`. Direction requires another call.
41
- - **5-exchange + 20-skill catalog refresh** below.
57
+ - **README hero refresh + track-record image embed.** No API, schema, or tool changes — public response shape and free-tier behavior unchanged from v1.10.6.
58
+
59
+ ---
60
+
61
+ ## What's new in v1.10.6
62
+
63
+ Live since 2026-05-06:
64
+
65
+ - **Free tier unlocked** — every supported coin + every supported timeframe is accessible at the free tier (was BTC/ETH on 15m/1h only). 100 calls/mo cap is the only ceiling. HOLD calls remain free at every tier. All 11 timeframes (`1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d`) callable on demand.
66
+ - **Free-tier exhaustion path** — when an agent hits the 100-calls/month cap, the response includes a direct upgrade link: `Free tier limit reached (X/100 calls this month). Upgrade to Starter ($9.99/mo) for 3,000 calls/mo, or pay per call via x402. → https://api.algovault.com/signup?plan=starter`
67
+ - **Output-sanitization v1** — composite-verdict-reverse-engineering surface closed (`rsi`, `ema_*`, `hurst`, `funding_z_score`, `squeeze_active` stripped from public response). `_algovault` metadata block + `also_see` cross-asset leads remain.
68
+ - **Connect-Your-MCP-Client docs** — Claude Desktop, Cursor, Cline, Claude Code, Smithery, plain HTTP/curl walkthroughs at [`algovault.com/docs.html#connect-mcp`](https://algovault.com/docs.html#connect-mcp).
69
+
70
+ > **Upgrading from v1.9.x or earlier?** MCP clients (Claude Desktop, Claude.ai custom connectors, Cursor, Cline) cache the tool list at session start. **Refresh your tool list:**
71
+ > - **Claude.ai / Claude Desktop**: Settings → Connectors → AlgoVault → toggle off + on
72
+ > - **Cursor / Cline**: restart the MCP server connection from the integration panel
42
73
 
43
74
  ---
44
75
 
@@ -50,12 +81,12 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
50
81
 
51
82
  **What makes this not just another indicator wrapper:**
52
83
 
53
- - **Composite scoring, not single-indicator noise.** Multiple orthogonal signals — momentum oscillators, trend structure, derivatives positioning, volume dynamics, open interest flow — fused into a single weighted verdict. The weights are calibrated from live market outcome data, not textbook defaults.
54
- - **Regime-aware call generation.** Calls are filtered through a market regime classifier before emission. The engine knows when to issue calls and when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast.
55
- - **Cross-venue intelligence.** Full signal generation on 5 exchanges — Hyperliquid, Binance, Bybit, OKX, and Bitget — with native candle, OI, funding, and volume data per venue. Cross-venue funding arbitrage scanning across all venues. Nobody else does multi-exchange derivatives analysis via MCP. <!-- SNAPSHOT-LINE -->
56
- - **Published track record with every release.** Every call is recorded with outcome prices at multiple horizons. Win rate, profit factor, and expected value are computed continuously. No cherry-picking, no survivorship bias.
57
- - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the call you get today is better than the one from last month.
58
- - **Crypto + TradFi coverage.** 710+ assets across 5 exchanges — standard crypto perps on all venues, TradFi perpetuals (stocks, indices, commodities, FX) on Hyperliquid, and liquidity-filtered meme coins. Assets are classified into quality tiers with per-exchange signal generation. <!-- SNAPSHOT-LINE -->
84
+ - **Composite scoring, not single-indicator noise.** Multiple orthogonal signals — momentum oscillators, trend structure, derivatives positioning, volume dynamics, open interest flow — fused into a single weighted verdict. Weights are calibrated from live market outcome data, not textbook defaults.
85
+ - **Regime-aware call generation.** Calls are filtered through a market regime classifier before emission. The engine knows when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast. (HOLD rate ~99%; we issue calls only when the edge is clear.) <!-- SNAPSHOT-LINE -->
86
+ - **Cross-venue intelligence.** Full signal generation on 5 exchanges with native candle, OI, funding, and volume data per venue. Cross-venue funding arbitrage scanning across all venues — nobody else does multi-exchange derivatives analysis via MCP. <!-- SNAPSHOT-LINE -->
87
+ - **Published track record with every release.** Every call is recorded with outcome prices at multiple horizons. PFE Win Rate, Profit Factor, Expected Value computed continuously. No cherry-picking, no survivorship bias. **Anchored on-chain on Base L2 — we cannot rewrite history.**
88
+ - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data via the [Autonomous Optimization Engine](https://algovault.com/track-record). The engine learns what works.
89
+ - **Crypto + TradFi coverage.** 720+ assets — standard crypto perps on all 5 venues, TradFi perpetuals (stocks, indices, commodities, FX) on Hyperliquid, liquidity-filtered meme coins. <!-- SNAPSHOT-LINE -->
59
90
 
60
91
  ---
61
92
 
@@ -94,19 +125,17 @@ Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any
94
125
 
95
126
  Under the hood: a multi-factor scoring engine evaluates momentum, trend structure, derivatives sentiment, open interest dynamics, and volume conviction. Scores pass through regime-aware filters and adaptive post-processing gates before a final verdict is emitted. Only high-conviction calls are generated; the engine stays silent when the edge is unclear.
96
127
 
97
- > Tool name `get_trade_signal` remains registered as an alias for backward compatibility — agents using the old name continue to work without changes. New integrations should call `get_trade_call`.
98
-
99
128
  **Parameters:**
100
- - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 290+ supported assets <!-- SNAPSHOT-LINE -->
129
+ - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 710+ supported assets <!-- SNAPSHOT-LINE -->
101
130
  - `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
102
131
  - `exchange` (string, default `"HL"`): `"HL"` (Hyperliquid), `"BINANCE"`, `"BYBIT"`, `"OKX"`, `"BITGET"`. TradFi assets (GOLD, TSLA, etc.) are HL-only.
103
132
  - `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
104
133
 
105
- **Output:** v1.10.0 sanitized shape — `call` direction, `confidence` (0–100), bucketed `indicators` (`funding_rate` / `funding_24h_avg` / `funding_state` / `oi_change_pct` / `volume_24h` / `trend_persistence` / `breakout_pending`), detected `regime`, sanitized `reasoning` prose, and `_algovault` metadata for downstream tool composability. The seven raw indicator fields (`rsi`, `ema_*`, `hurst`, `funding_z_score`, `squeeze_active`) were stripped in v1.10.0 to close composite-verdict reverse-engineering.
134
+ **Output:** v1.10.0 sanitized shape — `call` direction, `confidence` (0–100), bucketed `indicators` (`funding_rate` / `funding_24h_avg` / `funding_state` / `oi_change_pct` / `volume_24h` / `trend_persistence` / `breakout_pending`), detected `regime`, sanitized `reasoning` prose, and `_algovault` metadata for downstream tool composability.
106
135
 
107
- Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also_see` (top-3 cross-asset leads when the grid has non-HOLD cells), both trimmed to `{coin, timeframe, confidence}` only — direction requires another `get_trade_call` invocation.
136
+ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also_see` (top-3 cross-asset leads), trimmed to `{coin, timeframe, confidence}` only — direction requires another `get_trade_call` invocation.
108
137
 
109
- **Example response (v1.10.0):**
138
+ **Example response:**
110
139
 
111
140
  ```json
112
141
  {
@@ -132,7 +161,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
132
161
  { "coin": "SOL", "timeframe": "15m", "confidence": 73 }
133
162
  ],
134
163
  "_algovault": {
135
- "version": "1.10.0",
164
+ "version": "1.10.7",
136
165
  "tool": "get_trade_call",
137
166
  "compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
138
167
  }
@@ -141,31 +170,76 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
141
170
 
142
171
  ### `scan_funding_arb`
143
172
 
144
- Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads, and ranks opportunities by composite score (spread magnitude, time urgency, and funding conviction from 24h history). OKX and Bitget funding data is available via their respective adapters — arb scanning expansion is planned.
173
+ Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads, ranks opportunities by composite score (spread magnitude, time urgency, funding conviction from 24h history). OKX and Bitget funding data is available via their respective adapters — arb scanning expansion is planned.
145
174
 
146
- This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
175
+ This is the only MCP server providing cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
147
176
 
148
177
  **Parameters:**
149
178
  - `minSpreadBps` (number, default `5`): Minimum spread in basis points to include
150
- - `limit` (number, default `10`): Maximum results returned
179
+ - `limit` (number, default `10`): Maximum results returned (free tier capped at 5)
151
180
 
152
181
  **Output includes:** per-opportunity venue rates, optimal long/short direction, annualized spread percentage, and next funding timestamps.
153
182
 
154
183
  ### `get_market_regime`
155
184
 
156
- Classifies the current market environment into one of four regimes: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
185
+ Classifies the current market environment: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
157
186
 
158
- Uses a multi-dimensional classification approach combining directional strength measurement with ADX slope analysis (detecting trend strengthening vs exhaustion), volume-weighted pivot detection, ATR-adaptive funding thresholds, and cross-venue funding sentiment divergence. The regime classification directly informs how `get_trade_call` filters its output — agents can also use it independently for strategy selection and position sizing.
187
+ Combines directional strength measurement with ADX slope analysis (detecting trend strengthening vs exhaustion), volume-weighted pivot detection, ATR-adaptive funding thresholds, and cross-venue funding sentiment divergence. The regime classification directly informs how `get_trade_call` filters its output — agents can also use it independently for strategy selection and position sizing.
159
188
 
160
189
  **Parameters:**
161
190
  - `coin` (string, required): Asset symbol
162
191
  - `timeframe` (string, default `"4h"`): Candle timeframe for analysis
163
- - `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_call
192
+ - `exchange` (string, default `"HL"`): Exchange to analyze — same options as `get_trade_call`
164
193
 
165
194
  **Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
166
195
 
167
196
  ---
168
197
 
198
+ ## When You Hit the Free Limit
199
+
200
+ Free tier is 100 calls per calendar month. **HOLD calls don't count against it** — you only consume quota on BUY/SELL verdicts.
201
+
202
+ When the cap is reached, the next call's response includes:
203
+
204
+ ```
205
+ Free tier limit reached (100/100 calls this month).
206
+ Upgrade to Starter ($9.99/mo) for 3,000 calls/mo,
207
+ or pay per call via x402.
208
+ → https://api.algovault.com/signup?plan=starter
209
+ ```
210
+
211
+ **Two zero-friction upgrade paths:**
212
+
213
+ | Path | When to use | Friction |
214
+ |------|-------------|----------|
215
+ | **Starter $9.99/mo** | Your agent runs on a known schedule (cron, hourly digests, daily scans). | Stripe checkout · API key delivered instantly · [signup →](https://api.algovault.com/signup?plan=starter) |
216
+ | **x402 micropayment** | Your agent is autonomous and pays per call in USDC on Base. No signup. | Wallet · ~$0.01–0.05 per BUY/SELL · zero account state · [x402.org](https://x402.org) |
217
+
218
+ ---
219
+
220
+ ## Pricing
221
+
222
+ | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
223
+ |---------|------|-------------------|-------------|---------------------|-----------------|
224
+ | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
225
+ | Assets | All 720+ | All 720+ | All 720+ | All 720+ | All 720+ | <!-- SNAPSHOT-LINE-TABLE -->
226
+ | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
227
+ | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
228
+ | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
229
+ | Track record | Full access | Full access | Full access | Full access | Full access |
230
+ | Monthly calls | 100/mo | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
231
+ | Support | Community | Email | Priority | Dedicated | — |
232
+ | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
233
+ | HOLD calls | Free | Free | Free | Free | Free |
234
+
235
+ \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction. We only get paid when we see a tradeable opportunity.
236
+
237
+ **Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). Starter ($9.99/mo) unlocks 3,000 calls/mo. API key delivered instantly after checkout.
238
+
239
+ **x402 micropayments:** AI agents pay per HTTP call with USDC on Base — no signup, no API key, no billing. The payment receipt is the credential. See [x402.org](https://x402.org).
240
+
241
+ ---
242
+
169
243
  ## Integrations
170
244
 
171
245
  End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Kit. AlgoVault returns the analytics; the agent's risk policy decides what to execute. **All demos run testnet/demo only — zero real-money risk.**
@@ -173,54 +247,57 @@ End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Ki
173
247
  <!-- BUILD:README_INTEGRATIONS_TABLE -->
174
248
  | # | Exchange | Tutorial | Demo | Mirror |
175
249
  |---|---|---|---|---|
176
- | 01 | Binance | [`docs/integrations/binance.md`](docs/integrations/binance.md) | [`examples/binance/demo.mjs`](examples/binance/demo.mjs) | [algovault.com/docs/integrations/binance](https://algovault.com/docs/integrations/binance) |
177
- | 02 | OKX | [`docs/integrations/okx.md`](docs/integrations/okx.md) | [`examples/okx/demo.mjs`](examples/okx/demo.mjs) | [algovault.com/docs/integrations/okx](https://algovault.com/docs/integrations/okx) |
178
- | 03 | Bybit | [`docs/integrations/bybit.md`](docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](examples/bybit/demo.mjs) | [algovault.com/docs/integrations/bybit](https://algovault.com/docs/integrations/bybit) |
179
- | 04 | Bitget | [`docs/integrations/bitget.md`](docs/integrations/bitget.md) | [`examples/bitget/demo.mjs`](examples/bitget/demo.mjs) | [algovault.com/docs/integrations/bitget](https://algovault.com/docs/integrations/bitget) |
250
+ | 01 | Binance | [`docs/integrations/binance.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/binance.md) | [`examples/binance/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/binance/demo.mjs) | [algovault.com/docs/integrations/binance](https://algovault.com/docs/integrations/binance) |
251
+ | 02 | OKX | [`docs/integrations/okx.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/okx.md) | [`examples/okx/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/okx/demo.mjs) | [algovault.com/docs/integrations/okx](https://algovault.com/docs/integrations/okx) |
252
+ | 03 | Bybit | [`docs/integrations/bybit.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/bybit/demo.mjs) | [algovault.com/docs/integrations/bybit](https://algovault.com/docs/integrations/bybit) |
253
+ | 04 | Bitget | [`docs/integrations/bitget.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/bitget.md) | [`examples/bitget/demo.mjs`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/bitget/demo.mjs) | [algovault.com/docs/integrations/bitget](https://algovault.com/docs/integrations/bitget) |
180
254
  <!-- /BUILD:README_INTEGRATIONS_TABLE -->
181
255
 
182
- Distribution surface tracker: [`algovault-skills/docs/INTEGRATIONS_DISTRIBUTION.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/INTEGRATIONS_DISTRIBUTION.md).
183
-
184
256
  ---
185
257
 
186
- ## Skills
258
+ ## Skills (20 ready-to-use Anthropic Agent Skills)
187
259
 
188
- 20 ready-to-use Anthropic Agent Skills wrapping the AlgoVault MCP server. Each Skill is a single-prompt wrapper over 1–3 tool calls — composite verdicts, regime gating, multi-timeframe consensus, funding-arb monitoring, and more.
260
+ 20 single-prompt wrappers over 1–3 AlgoVault tool calls — composite verdicts, regime gating, multi-timeframe consensus, funding-arb monitoring, and more.
189
261
 
190
262
  ```bash
191
263
  claude plugin install AlgoVaultLabs/algovault-skills
192
264
  ```
193
265
 
194
- Browse the full catalog at <https://algovault.com/skills> or <https://github.com/AlgoVaultLabs/algovault-skills>.
266
+ Browse the full catalog at [algovault.com/skills](https://algovault.com/skills) or [github.com/AlgoVaultLabs/algovault-skills](https://github.com/AlgoVaultLabs/algovault-skills).
267
+
268
+ <details>
269
+ <summary><strong>Show all 20 Skills</strong></summary>
195
270
 
196
271
  <!-- BUILD:README_SKILLS_TABLE -->
197
272
  | # | Slug | Name | Difficulty | Tools |
198
273
  |---|---|---|---|---|
199
- | 01 | [`quick-btc-check`](skills/quick-btc-check/SKILL.md) | Quick BTC Check | Beginner | `get_trade_call` |
200
- | 02 | [`portfolio-scanner`](skills/portfolio-scanner/SKILL.md) | Portfolio Scanner | Intermediate | `get_trade_call` |
201
- | 03 | [`regime-aware-trading`](skills/regime-aware-trading/SKILL.md) | Regime-Aware Trading | Intermediate | `get_market_regime`, `get_trade_call` |
202
- | 04 | [`funding-arb-monitor`](skills/funding-arb-monitor/SKILL.md) | Funding Arb Monitor | Intermediate | `scan_funding_arb` |
203
- | 05 | [`full-3-tool-pipeline`](skills/full-3-tool-pipeline/SKILL.md) | Full 3-Tool Pipeline | Advanced | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
204
- | 06 | [`multi-timeframe-confirmation`](skills/multi-timeframe-confirmation/SKILL.md) | Multi-Timeframe Confirmation | Advanced | `get_trade_call` |
205
- | 07 | [`tradfi-rotation`](skills/tradfi-rotation/SKILL.md) | TradFi Rotation | Advanced | `get_market_regime`, `get_trade_call` |
206
- | 08 | [`risk-gated-entry`](skills/risk-gated-entry/SKILL.md) | Risk-Gated Entry | Advanced | `get_market_regime`, `get_trade_call` |
207
- | 09 | [`funding-sentiment-dashboard`](skills/funding-sentiment-dashboard/SKILL.md) | Funding Sentiment Dashboard | Advanced | `get_market_regime` |
208
- | 10 | [`contrarian-meme-scanner`](skills/contrarian-meme-scanner/SKILL.md) | Contrarian Meme Scanner | Advanced | `get_market_regime`, `get_trade_call` |
209
- | 11 | [`divergence-detector`](skills/divergence-detector/SKILL.md) | Divergence Detector | Advanced | `get_market_regime`, `get_trade_call` |
210
- | 12 | [`hourly-digest-bot`](skills/hourly-digest-bot/SKILL.md) | Hourly Digest Bot | Advanced | `get_trade_call`, `get_market_regime` |
211
- | 13 | [`hedging-advisor`](skills/hedging-advisor/SKILL.md) | Hedging Advisor | Advanced | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
212
- | 14 | [`volatility-breakout-watch`](skills/volatility-breakout-watch/SKILL.md) | Volatility Breakout Watch | Advanced | `get_market_regime`, `get_trade_call` |
213
- | 15 | [`cross-asset-correlation`](skills/cross-asset-correlation/SKILL.md) | Cross-Asset Correlation | Advanced | `get_trade_call` |
214
- | 16 | [`funding-cash-and-carry`](skills/funding-cash-and-carry/SKILL.md) | Funding Cash-and-Carry | Advanced | `scan_funding_arb`, `get_trade_call` |
215
- | 17 | [`weekend-vs-weekday-patterns`](skills/weekend-vs-weekday-patterns/SKILL.md) | Weekend vs Weekday Patterns | Research | `get_trade_call`, `get_market_regime` |
216
- | 18 | [`agent-portfolio-rebalance`](skills/agent-portfolio-rebalance/SKILL.md) | Agent Portfolio Rebalance | Advanced | `get_market_regime` |
217
- | 19 | [`smart-dca-bot`](skills/smart-dca-bot/SKILL.md) | Smart DCA Bot | Advanced | `get_trade_call` |
218
- | 20 | [`multi-agent-war-room`](skills/multi-agent-war-room/SKILL.md) | Multi-Agent War Room | Expert | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
274
+ | 01 | [`quick-btc-check`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/quick-btc-check/SKILL.md) | Quick BTC Check | Beginner | `get_trade_call` |
275
+ | 02 | [`portfolio-scanner`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/portfolio-scanner/SKILL.md) | Portfolio Scanner | Intermediate | `get_trade_call` |
276
+ | 03 | [`regime-aware-trading`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/regime-aware-trading/SKILL.md) | Regime-Aware Trading | Intermediate | `get_market_regime`, `get_trade_call` |
277
+ | 04 | [`funding-arb-monitor`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/funding-arb-monitor/SKILL.md) | Funding Arb Monitor | Intermediate | `scan_funding_arb` |
278
+ | 05 | [`full-3-tool-pipeline`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/full-3-tool-pipeline/SKILL.md) | Full 3-Tool Pipeline | Advanced | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
279
+ | 06 | [`multi-timeframe-confirmation`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/multi-timeframe-confirmation/SKILL.md) | Multi-Timeframe Confirmation | Advanced | `get_trade_call` |
280
+ | 07 | [`tradfi-rotation`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/tradfi-rotation/SKILL.md) | TradFi Rotation | Advanced | `get_market_regime`, `get_trade_call` |
281
+ | 08 | [`risk-gated-entry`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/risk-gated-entry/SKILL.md) | Risk-Gated Entry | Advanced | `get_market_regime`, `get_trade_call` |
282
+ | 09 | [`funding-sentiment-dashboard`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/funding-sentiment-dashboard/SKILL.md) | Funding Sentiment Dashboard | Advanced | `get_market_regime` |
283
+ | 10 | [`contrarian-meme-scanner`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/contrarian-meme-scanner/SKILL.md) | Contrarian Meme Scanner | Advanced | `get_market_regime`, `get_trade_call` |
284
+ | 11 | [`divergence-detector`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/divergence-detector/SKILL.md) | Divergence Detector | Advanced | `get_market_regime`, `get_trade_call` |
285
+ | 12 | [`hourly-digest-bot`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/hourly-digest-bot/SKILL.md) | Hourly Digest Bot | Advanced | `get_trade_call`, `get_market_regime` |
286
+ | 13 | [`hedging-advisor`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/hedging-advisor/SKILL.md) | Hedging Advisor | Advanced | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
287
+ | 14 | [`volatility-breakout-watch`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/volatility-breakout-watch/SKILL.md) | Volatility Breakout Watch | Advanced | `get_market_regime`, `get_trade_call` |
288
+ | 15 | [`cross-asset-correlation`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/cross-asset-correlation/SKILL.md) | Cross-Asset Correlation | Advanced | `get_trade_call` |
289
+ | 16 | [`funding-cash-and-carry`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/funding-cash-and-carry/SKILL.md) | Funding Cash-and-Carry | Advanced | `scan_funding_arb`, `get_trade_call` |
290
+ | 17 | [`weekend-vs-weekday-patterns`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/weekend-vs-weekday-patterns/SKILL.md) | Weekend vs Weekday Patterns | Research | `get_trade_call`, `get_market_regime` |
291
+ | 18 | [`agent-portfolio-rebalance`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/agent-portfolio-rebalance/SKILL.md) | Agent Portfolio Rebalance | Advanced | `get_market_regime` |
292
+ | 19 | [`smart-dca-bot`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/smart-dca-bot/SKILL.md) | Smart DCA Bot | Advanced | `get_trade_call` |
293
+ | 20 | [`multi-agent-war-room`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/skills/multi-agent-war-room/SKILL.md) | Multi-Agent War Room | Expert | `get_market_regime`, `get_trade_call`, `scan_funding_arb` |
219
294
  <!-- /BUILD:README_SKILLS_TABLE -->
220
295
 
296
+ </details>
297
+
221
298
  ---
222
299
 
223
- ## Performance Tracking
300
+ ## Performance Tracking & On-Chain Verification
224
301
 
225
302
  Every call is tracked from emission to outcome. No exceptions.
226
303
 
@@ -232,47 +309,17 @@ Every call is tracked from emission to outcome. No exceptions.
232
309
  - Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
233
310
  - Running statistics per asset, timeframe, and quality tier
234
311
 
235
- **HOLD calls are free** — when the engine says "don't trade," you don't pay. Only BUY and SELL verdicts are charged via x402 or count against subscription quotas. This aligns our incentives: you only pay when we see a tradeable opportunity.
236
-
237
- - **HOLD Rate**: Percentage of scans where the engine declines to issue a trade call. A high HOLD rate (currently ~84%) means the engine is selective — it only calls BUY/SELL when conditions align across multiple indicators.
238
-
239
- **Infrastructure:**
240
- - Remote mode: PostgreSQL with automated outcome backfill
241
- - Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
242
- - Only high-confidence BUY/SELL calls are tracked — HOLD is excluded
243
- - Signals are tracked per exchange — the track record shows performance on each venue independently
312
+ **HOLD calls are free.** When the engine says "don't trade," you don't pay. Only BUY/SELL verdicts charge x402 or count against subscription quotas. Aligns incentives: we only get paid when we see a tradeable opportunity. Current HOLD rate ~99%. <!-- SNAPSHOT-LINE -->
244
313
 
245
314
  ### On-Chain Verification
246
315
 
247
- Every call is hashed (keccak256) at creation time and anchored on Base L2 via daily Merkle batches. This makes the track record tamper-proof — we cannot edit past calls.
316
+ Every call is hashed (keccak256) at creation time and anchored on Base L2 via daily Merkle batches. The track record is tamper-proof — we cannot edit past calls.
248
317
 
249
318
  - **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
250
- - **Verify any call**: `https://api.algovault.com/api/verify-signal?signalId=<ID>`
251
- - **View all batches**: `https://api.algovault.com/api/merkle-batches`
319
+ - **Verify any call**: [`api.algovault.com/api/verify-signal?signalId=<ID>`](https://api.algovault.com/api/verify-signal)
320
+ - **View all batches**: [`api.algovault.com/api/merkle-batches`](https://api.algovault.com/api/merkle-batches)
252
321
  - **Visual verification**: [algovault.com/verify](https://algovault.com/verify)
253
-
254
- ---
255
-
256
- ## Pricing
257
-
258
- | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
259
- |---------|------|-------------------|-------------|---------------------|-----------------|
260
- | Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
261
- | Assets | All 710+ | All 710+ | All 710+ | All 710+ | All 710+ | <!-- SNAPSHOT-LINE-TABLE -->
262
- | Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
263
- | Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 | <!-- SNAPSHOT-LINE-TABLE -->
264
- | Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
265
- | Track record | Full access | Full access | Full access | Full access | Full access |
266
- | Monthly calls | 100/mo | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
267
- | Support | Community | Email | Priority | Dedicated | — |
268
- | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
269
- | HOLD calls | Free | Free | Free | Free | Free |
270
-
271
- \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction.
272
-
273
- **x402 micropayments:** AI agents pay per HTTP call with USDC on Base — no signup, no API key, no billing. The payment receipt is the credential. See [x402.org](https://x402.org).
274
-
275
- **Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). Starter ($9.99/mo) unlocks all assets and timeframes. API key delivered instantly after checkout.
322
+ - **Live dashboard**: [algovault.com/track-record](https://algovault.com/track-record)
276
323
 
277
324
  ---
278
325
 
@@ -334,7 +381,7 @@ api.algovault.com/mcp (Streamable HTTP)
334
381
  │
335
382
  ├─ x402 payment verification (USDC on Base)
336
383
  ├─ API key / subscription check
337
- ├─ Free tier fallback
384
+ ├─ Free tier fallback (100 calls/mo, all assets, all timeframes)
338
385
  │
339
386
  ▼
340
387
  MCP Server (Express + @modelcontextprotocol/sdk)
@@ -361,8 +408,6 @@ MCP Server (Express + @modelcontextprotocol/sdk)
361
408
  └─ Exchange Public APIs (free, no auth — all 5 venues)
362
409
  ```
363
410
 
364
- **Exchange adapter pattern:** All exchange interactions go through the `ExchangeAdapter` interface — supporting full signal generation on all 5 exchanges. Each adapter implements candles, OI, funding rates, and current price via native exchange APIs. TradFi perps are Hyperliquid-exclusive. <!-- SNAPSHOT-LINE -->
365
-
366
411
  ---
367
412
 
368
413
  ## Suite Composability
@@ -395,6 +440,10 @@ MIT
395
440
 
396
441
  > **Disclaimer:** AlgoVault provides directional entry interpretation for AI agents. Exit timing is determined by your agent or strategy. This is not financial advice. Past performance does not guarantee future results.
397
442
 
398
- Built by [AlgoVault Labs](https://algovault.com)
399
-
400
- [Landing page](https://algovault.com) · [API endpoint](https://api.algovault.com/mcp)
443
+ <p align="center">
444
+ Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/>
445
+ <a href="https://algovault.com">algovault.com</a> ·
446
+ <a href="https://algovault.com/track-record">track-record</a> ·
447
+ <a href="https://api.algovault.com/mcp">MCP endpoint</a> ·
448
+ <a href="https://api.algovault.com/signup">sign up</a>
449
+ </p>
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4mDpE,wBAAgB,mBAAmB,cAElC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAunDpE,wBAAgB,mBAAmB,cAElC"}
package/dist/index.js CHANGED
@@ -999,6 +999,12 @@ function renderAssets(data) {
999
999
  // Canonical 20 Skill slugs — table renders all 20 even with zero invocations.
1000
1000
  // Kept in sync with skills/manifest.json in github.com/AlgoVaultLabs/algovault-skills.
1001
1001
  const SKILL_SLUGS = ['quick-btc-check','portfolio-scanner','regime-aware-trading','funding-arb-monitor','full-3-tool-pipeline','multi-timeframe-confirmation','tradfi-rotation','risk-gated-entry','funding-sentiment-dashboard','contrarian-meme-scanner','divergence-detector','hourly-digest-bot','hedging-advisor','volatility-breakout-watch','cross-asset-correlation','funding-cash-and-carry','weekend-vs-weekday-patterns','agent-portfolio-rebalance','smart-dca-bot','multi-agent-war-room'];
1002
+ // Canonical license tiers — Calls by Tier table renders all 5 even at zero
1003
+ // count, so operators can monitor enterprise + x402 traffic the moment it
1004
+ // starts (instead of "tier just appeared today" silent change). Order is
1005
+ // price-asc with x402 last (pay-per-call sits outside the subscription ladder).
1006
+ // Kept in sync with LicenseTier enum in src/types.ts.
1007
+ const LICENSE_TIERS = ['free','starter','pro','enterprise','x402'];
1002
1008
  function escSlug(s) { return String(s).replace(/[<>&]/g,''); }
1003
1009
  function fmtTs(s) {
1004
1010
  if (!s) return '<span style="color:#6e7681">never</span>';
@@ -1039,7 +1045,12 @@ async function load() {
1039
1045
  document.getElementById('sessions-all').textContent = d.uniqueSessions.allTime;
1040
1046
  document.getElementById('sessions-24h').textContent = d.uniqueSessions.last24h;
1041
1047
  renderRows('by-tool', d.byTool);
1042
- renderRows('by-tier', d.byTier);
1048
+ // Pre-fill all 5 canonical license tiers (zero-fill missing) so empty
1049
+ // buckets like enterprise + x402 always show as "0" rows. Mirrors the
1050
+ // SKILL_SLUGS pattern at line ~1066: explicit canonical-list expansion
1051
+ // beats "render whatever the API returns" for monitoring surfaces.
1052
+ const tierFilled = Object.fromEntries(LICENSE_TIERS.map(t => [t, (d.byTier && d.byTier[t]) || 0]));
1053
+ renderRows('by-tier', tierFilled);
1043
1054
  renderAssets(d.topAssets);
1044
1055
  // C1 (LATENCY-W1): truthful per-tool latency table — n / p50 / p95 / min / max.
1045
1056
  // Replaces the misleading single-number avg (a bimodal distribution averaged 7.8s