crypto-quant-signal-mcp 1.10.6 → 1.10.8
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 +144 -90
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +41 -52
- package/dist/index.js.map +1 -1
- package/dist/lib/analytics.d.ts +1 -0
- package/dist/lib/analytics.d.ts.map +1 -1
- package/dist/lib/analytics.js +22 -3
- package/dist/lib/analytics.js.map +1 -1
- package/dist/lib/asset-tiers.d.ts +10 -0
- package/dist/lib/asset-tiers.d.ts.map +1 -1
- package/dist/lib/asset-tiers.js +52 -1
- package/dist/lib/asset-tiers.js.map +1 -1
- package/dist/lib/bot-auth.d.ts +18 -0
- package/dist/lib/bot-auth.d.ts.map +1 -0
- package/dist/lib/bot-auth.js +28 -0
- package/dist/lib/bot-auth.js.map +1 -0
- package/dist/lib/license.d.ts +2 -2
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +41 -4
- package/dist/lib/license.js.map +1 -1
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +39 -36
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/welcome-page.d.ts +13 -0
- package/dist/lib/welcome-page.d.ts.map +1 -0
- package/dist/lib/welcome-page.js +79 -0
- package/dist/lib/welcome-page.js.map +1 -0
- package/dist/scripts/monitor.js +113 -19
- package/dist/scripts/monitor.js.map +1 -1
- package/dist/types.d.ts +1 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -1,44 +1,72 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<
|
|
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
|
-
|
|
7
|
+
<h1 align="center">crypto-quant-signal-mcp</h1>
|
|
6
8
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
[](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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
31
|
+
## 📊 Live Track Record — Public, Verifiable, On-Chain
|
|
21
32
|
|
|
22
|
-
|
|
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
|
-
|
|
25
|
-
-
|
|
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
|
-
>
|
|
28
|
-
|
|
29
|
-
>
|
|
30
|
-
|
|
31
|
-
|
|
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.
|
|
53
|
+
## What's new in v1.10.8
|
|
54
|
+
|
|
55
|
+
Live since 2026-05-08:
|
|
56
|
+
|
|
57
|
+
- **🤖 Public Telegram bot — [@algovaultofficialbot](https://t.me/algovaultofficialbot).** AlgoVault verdicts now push to your phone. Set a watchlist with `/watch BTC 4h` and the bot delivers regime shifts and BUY/SELL trade calls in real time. Built on the same composite-verdict signal stream that powers the MCP — same 90.0% PFE win rate, same on-chain track record, now in your pocket. <!-- SNAPSHOT-LINE -->
|
|
58
|
+
|
|
59
|
+
- **📱 One-click link from `/welcome`.** After Stripe checkout, the welcome page shows a "Connect @algovaultofficialbot" button. One click binds your Telegram chat to your subscription — your paid tier unlocks unlimited bot pushes instantly, no API-key copy-paste, no auth dance. Free-tier users get 100 trade-call alerts/month before the upgrade prompt fires.
|
|
60
|
+
|
|
61
|
+
- **🧠 Smart routing built in.** HOLD verdicts stay silent (no spam, no quota tick). Regime alerts are flap-suppressed — fires only after 2 consecutive same-regime confirmations, so you get the shift, not the noise. Per-timeframe dispatch means a 1-minute pair fires every minute and a daily pair fires once a day — you control the cadence by what you watch.
|
|
62
|
+
|
|
63
|
+
- **🌐 Full coverage parity.** Every asset (720+), every timeframe (1m → 1d), every exchange (HL · Binance · Bybit · OKX · Bitget) — all callable from the bot, same as the API. Pick what you want to track; the bot handles the polling.
|
|
36
64
|
|
|
37
|
-
|
|
65
|
+
- **📈 Trade calls that count cleanly.** Bot-pushed BUY/SELL alerts tick your free-tier monthly cap (matching the API's 100/mo) and stop ticking the moment your subscription is linked. No double-counting, no surprise overage — your real Stripe-backed quota (3K/15K/100K) governs everything.
|
|
38
66
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
- **
|
|
67
|
+
> **Upgrading from v1.10.6 or earlier?** MCP clients (Claude Desktop, Claude.ai custom connectors, Cursor, Cline) cache the tool list at session start. The MCP tool surface is unchanged in v1.10.8, but if you signed up before today and want bot access:
|
|
68
|
+
> - **Already a subscriber?** Visit your `/welcome` link from the original signup email — the new button lives there. Or hit `api.algovault.com/account` to recover your key, then sign up at [@algovaultofficialbot](https://t.me/algovaultofficialbot).
|
|
69
|
+
> - **Free tier?** [Start the bot](https://t.me/algovaultofficialbot), `/watch` your first asset, get free regime alerts forever and 100 trade-call alerts/month.
|
|
42
70
|
|
|
43
71
|
---
|
|
44
72
|
|
|
@@ -50,12 +78,12 @@ AlgoVault is different. We give your agent **one answer**: a directional verdict
|
|
|
50
78
|
|
|
51
79
|
**What makes this not just another indicator wrapper:**
|
|
52
80
|
|
|
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.
|
|
54
|
-
- **Regime-aware call generation.** Calls are filtered through a market regime classifier before emission. The engine knows when to
|
|
55
|
-
- **Cross-venue intelligence.** Full signal generation on 5 exchanges
|
|
56
|
-
- **Published track record with every release.** Every call is recorded with outcome prices at multiple horizons. Win
|
|
57
|
-
- **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works
|
|
58
|
-
- **Crypto + TradFi coverage.**
|
|
81
|
+
- **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.
|
|
82
|
+
- **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 -->
|
|
83
|
+
- **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 -->
|
|
84
|
+
- **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.**
|
|
85
|
+
- **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.
|
|
86
|
+
- **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
87
|
|
|
60
88
|
---
|
|
61
89
|
|
|
@@ -94,19 +122,17 @@ Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any
|
|
|
94
122
|
|
|
95
123
|
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
124
|
|
|
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
125
|
**Parameters:**
|
|
100
|
-
- `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of
|
|
126
|
+
- `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 710+ supported assets <!-- SNAPSHOT-LINE -->
|
|
101
127
|
- `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
|
|
102
128
|
- `exchange` (string, default `"HL"`): `"HL"` (Hyperliquid), `"BINANCE"`, `"BYBIT"`, `"OKX"`, `"BITGET"`. TradFi assets (GOLD, TSLA, etc.) are HL-only.
|
|
103
129
|
- `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
|
|
104
130
|
|
|
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.
|
|
131
|
+
**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
132
|
|
|
107
|
-
Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also_see` (top-3 cross-asset leads
|
|
133
|
+
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
134
|
|
|
109
|
-
**Example response
|
|
135
|
+
**Example response:**
|
|
110
136
|
|
|
111
137
|
```json
|
|
112
138
|
{
|
|
@@ -132,7 +158,7 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
|
|
|
132
158
|
{ "coin": "SOL", "timeframe": "15m", "confidence": 73 }
|
|
133
159
|
],
|
|
134
160
|
"_algovault": {
|
|
135
|
-
"version": "1.10.
|
|
161
|
+
"version": "1.10.7",
|
|
136
162
|
"tool": "get_trade_call",
|
|
137
163
|
"compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
|
|
138
164
|
}
|
|
@@ -141,31 +167,84 @@ Responses also include optional `closest_tradeable` (on HOLD verdicts) and `also
|
|
|
141
167
|
|
|
142
168
|
### `scan_funding_arb`
|
|
143
169
|
|
|
144
|
-
Scans cross-venue funding rate differentials across Hyperliquid, Binance, and Bybit. Normalizes hourly vs 8-hour rate conventions, computes basis-point spreads,
|
|
170
|
+
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
171
|
|
|
146
|
-
This is the only MCP server
|
|
172
|
+
This is the only MCP server providing cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
|
|
147
173
|
|
|
148
174
|
**Parameters:**
|
|
149
175
|
- `minSpreadBps` (number, default `5`): Minimum spread in basis points to include
|
|
150
|
-
- `limit` (number, default `10`): Maximum results returned
|
|
176
|
+
- `limit` (number, default `10`): Maximum results returned (free tier capped at 5)
|
|
151
177
|
|
|
152
178
|
**Output includes:** per-opportunity venue rates, optimal long/short direction, annualized spread percentage, and next funding timestamps.
|
|
153
179
|
|
|
154
180
|
### `get_market_regime`
|
|
155
181
|
|
|
156
|
-
Classifies the current market environment
|
|
182
|
+
Classifies the current market environment: **TRENDING_UP**, **TRENDING_DOWN**, **RANGING**, or **VOLATILE**.
|
|
157
183
|
|
|
158
|
-
|
|
184
|
+
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
185
|
|
|
160
186
|
**Parameters:**
|
|
161
187
|
- `coin` (string, required): Asset symbol
|
|
162
188
|
- `timeframe` (string, default `"4h"`): Candle timeframe for analysis
|
|
163
|
-
- `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_call
|
|
189
|
+
- `exchange` (string, default `"HL"`): Exchange to analyze — same options as `get_trade_call`
|
|
164
190
|
|
|
165
191
|
**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
192
|
|
|
167
193
|
---
|
|
168
194
|
|
|
195
|
+
## Free Telegram bot — `@algovaultofficialbot`
|
|
196
|
+
|
|
197
|
+
Want regime alerts + AlgoVault trade calls (BUY / SELL) pushed to a Telegram chat without writing any code? Open Telegram → search `@algovaultofficialbot` → `/start`. The bot is a thin client over this same MCP server — the same composite-verdict signal stream, no extra subscription, your free 100-calls/mo quota is shared with bot-driven calls.
|
|
198
|
+
|
|
199
|
+
Source: [github.com/AlgoVaultLabs/algovault-bot](https://github.com/AlgoVaultLabs/algovault-bot).
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## When You Hit the Free Limit
|
|
204
|
+
|
|
205
|
+
Free tier is 100 calls per calendar month. **HOLD calls don't count against it** — you only consume quota on BUY/SELL verdicts.
|
|
206
|
+
|
|
207
|
+
When the cap is reached, the next call's response includes:
|
|
208
|
+
|
|
209
|
+
```
|
|
210
|
+
Free tier limit reached (100/100 calls this month).
|
|
211
|
+
Upgrade to Starter ($9.99/mo) for 3,000 calls/mo,
|
|
212
|
+
or pay per call via x402.
|
|
213
|
+
→ https://api.algovault.com/signup?plan=starter
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
**Two zero-friction upgrade paths:**
|
|
217
|
+
|
|
218
|
+
| Path | When to use | Friction |
|
|
219
|
+
|------|-------------|----------|
|
|
220
|
+
| **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) |
|
|
221
|
+
| **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) |
|
|
222
|
+
|
|
223
|
+
---
|
|
224
|
+
|
|
225
|
+
## Pricing
|
|
226
|
+
|
|
227
|
+
| Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
|
|
228
|
+
|---------|------|-------------------|-------------|---------------------|-----------------|
|
|
229
|
+
| Exchanges | All 5 | All 5 | All 5 | All 5 | All 5 | <!-- SNAPSHOT-LINE-TABLE -->
|
|
230
|
+
| Assets | All 720+ | All 720+ | All 720+ | All 720+ | All 720+ | <!-- SNAPSHOT-LINE-TABLE -->
|
|
231
|
+
| Asset classes | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
|
|
232
|
+
| Timeframes | All 11 | All 11 | All 11 | All 11 | All 11 |
|
|
233
|
+
| Funding arb results | Top 5 | Unlimited | Unlimited | Unlimited | Unlimited |
|
|
234
|
+
| Track record | Full access | Full access | Full access | Full access | Full access |
|
|
235
|
+
| Monthly calls | 100/mo | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
|
|
236
|
+
| Support | Community | Email | Priority | Dedicated | — |
|
|
237
|
+
| Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
|
|
238
|
+
| HOLD calls | Free | Free | Free | Free | Free |
|
|
239
|
+
|
|
240
|
+
\* 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.
|
|
241
|
+
|
|
242
|
+
**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.
|
|
243
|
+
|
|
244
|
+
**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).
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
169
248
|
## Integrations
|
|
170
249
|
|
|
171
250
|
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.**
|
|
@@ -179,19 +258,20 @@ End-to-end tutorials pairing AlgoVault with each major exchange's Agent Trade Ki
|
|
|
179
258
|
| 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
259
|
<!-- /BUILD:README_INTEGRATIONS_TABLE -->
|
|
181
260
|
|
|
182
|
-
Distribution surface tracker: [`algovault-skills/docs/INTEGRATIONS_DISTRIBUTION.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/INTEGRATIONS_DISTRIBUTION.md).
|
|
183
|
-
|
|
184
261
|
---
|
|
185
262
|
|
|
186
|
-
## Skills
|
|
263
|
+
## Skills (20 ready-to-use Anthropic Agent Skills)
|
|
187
264
|
|
|
188
|
-
20
|
|
265
|
+
20 single-prompt wrappers over 1–3 AlgoVault tool calls — composite verdicts, regime gating, multi-timeframe consensus, funding-arb monitoring, and more.
|
|
189
266
|
|
|
190
267
|
```bash
|
|
191
268
|
claude plugin install AlgoVaultLabs/algovault-skills
|
|
192
269
|
```
|
|
193
270
|
|
|
194
|
-
Browse the full catalog at
|
|
271
|
+
Browse the full catalog at [algovault.com/skills](https://algovault.com/skills) or [github.com/AlgoVaultLabs/algovault-skills](https://github.com/AlgoVaultLabs/algovault-skills).
|
|
272
|
+
|
|
273
|
+
<details>
|
|
274
|
+
<summary><strong>Show all 20 Skills</strong></summary>
|
|
195
275
|
|
|
196
276
|
<!-- BUILD:README_SKILLS_TABLE -->
|
|
197
277
|
| # | Slug | Name | Difficulty | Tools |
|
|
@@ -218,9 +298,11 @@ Browse the full catalog at <https://algovault.com/skills> or <https://github.com
|
|
|
218
298
|
| 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
299
|
<!-- /BUILD:README_SKILLS_TABLE -->
|
|
220
300
|
|
|
301
|
+
</details>
|
|
302
|
+
|
|
221
303
|
---
|
|
222
304
|
|
|
223
|
-
## Performance Tracking
|
|
305
|
+
## Performance Tracking & On-Chain Verification
|
|
224
306
|
|
|
225
307
|
Every call is tracked from emission to outcome. No exceptions.
|
|
226
308
|
|
|
@@ -232,47 +314,17 @@ Every call is tracked from emission to outcome. No exceptions.
|
|
|
232
314
|
- Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
|
|
233
315
|
- Running statistics per asset, timeframe, and quality tier
|
|
234
316
|
|
|
235
|
-
**HOLD calls are free
|
|
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
|
|
317
|
+
**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
318
|
|
|
245
319
|
### On-Chain Verification
|
|
246
320
|
|
|
247
|
-
Every call is hashed (keccak256) at creation time and anchored on Base L2 via daily Merkle batches.
|
|
321
|
+
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
322
|
|
|
249
323
|
- **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
|
|
250
|
-
- **Verify any call**: `
|
|
251
|
-
- **View all batches**: `https://api.algovault.com/api/merkle-batches
|
|
324
|
+
- **Verify any call**: [`api.algovault.com/api/verify-signal?signalId=<ID>`](https://api.algovault.com/api/verify-signal)
|
|
325
|
+
- **View all batches**: [`api.algovault.com/api/merkle-batches`](https://api.algovault.com/api/merkle-batches)
|
|
252
326
|
- **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.
|
|
327
|
+
- **Live dashboard**: [algovault.com/track-record](https://algovault.com/track-record)
|
|
276
328
|
|
|
277
329
|
---
|
|
278
330
|
|
|
@@ -334,7 +386,7 @@ api.algovault.com/mcp (Streamable HTTP)
|
|
|
334
386
|
│
|
|
335
387
|
├─ x402 payment verification (USDC on Base)
|
|
336
388
|
├─ API key / subscription check
|
|
337
|
-
├─ Free tier fallback
|
|
389
|
+
├─ Free tier fallback (100 calls/mo, all assets, all timeframes)
|
|
338
390
|
│
|
|
339
391
|
▼
|
|
340
392
|
MCP Server (Express + @modelcontextprotocol/sdk)
|
|
@@ -361,8 +413,6 @@ MCP Server (Express + @modelcontextprotocol/sdk)
|
|
|
361
413
|
└─ Exchange Public APIs (free, no auth — all 5 venues)
|
|
362
414
|
```
|
|
363
415
|
|
|
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
416
|
---
|
|
367
417
|
|
|
368
418
|
## Suite Composability
|
|
@@ -395,6 +445,10 @@ MIT
|
|
|
395
445
|
|
|
396
446
|
> **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
447
|
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
448
|
+
<p align="center">
|
|
449
|
+
Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/>
|
|
450
|
+
<a href="https://algovault.com">algovault.com</a> ·
|
|
451
|
+
<a href="https://algovault.com/track-record">track-record</a> ·
|
|
452
|
+
<a href="https://api.algovault.com/mcp">MCP endpoint</a> ·
|
|
453
|
+
<a href="https://api.algovault.com/signup">sign up</a>
|
|
454
|
+
</p>
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqpDpE,wBAAgB,mBAAmB,cAElC"}
|
package/dist/index.js
CHANGED
|
@@ -68,6 +68,8 @@ const analytics_summary_js_1 = require("./resources/analytics-summary.js");
|
|
|
68
68
|
const skills_analytics_js_1 = require("./resources/skills-analytics.js");
|
|
69
69
|
const stripe_js_1 = require("./lib/stripe.js");
|
|
70
70
|
const errors_js_1 = require("./lib/errors.js");
|
|
71
|
+
const bot_auth_js_1 = require("./lib/bot-auth.js");
|
|
72
|
+
const welcome_page_js_1 = require("./lib/welcome-page.js");
|
|
71
73
|
/**
|
|
72
74
|
* Format a thrown error into the MCP tool-content payload. v1.10.2: when the
|
|
73
75
|
* cause is `UpstreamRateLimitError`, emit a structured `{error_code, exchange,
|
|
@@ -143,6 +145,7 @@ function createServer() {
|
|
|
143
145
|
verdict: result.call,
|
|
144
146
|
confidence: result.confidence,
|
|
145
147
|
ipHash: (0, license_js_1.getRequestIpHash)(),
|
|
148
|
+
isBotInternal: license.tier === 'internal',
|
|
146
149
|
});
|
|
147
150
|
const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
|
|
148
151
|
if (sessionIdForCohort !== null) {
|
|
@@ -182,6 +185,7 @@ function createServer() {
|
|
|
182
185
|
licenseTier: license.tier,
|
|
183
186
|
responseTimeMs: Date.now() - startMs,
|
|
184
187
|
ipHash: (0, license_js_1.getRequestIpHash)(),
|
|
188
|
+
isBotInternal: license.tier === 'internal',
|
|
185
189
|
});
|
|
186
190
|
const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
|
|
187
191
|
if (sessionIdForCohort !== null) {
|
|
@@ -217,6 +221,7 @@ function createServer() {
|
|
|
217
221
|
licenseTier: license.tier,
|
|
218
222
|
responseTimeMs: Date.now() - startMs,
|
|
219
223
|
ipHash: (0, license_js_1.getRequestIpHash)(),
|
|
224
|
+
isBotInternal: license.tier === 'internal',
|
|
220
225
|
});
|
|
221
226
|
const sessionIdForCohort = (0, license_js_1.getRequestSessionId)() ?? null;
|
|
222
227
|
if (sessionIdForCohort !== null) {
|
|
@@ -473,7 +478,7 @@ async function startHttp() {
|
|
|
473
478
|
return res.status(400).send('Missing session_id');
|
|
474
479
|
try {
|
|
475
480
|
const { apiKey, tier, email } = await (0, stripe_js_1.getCustomerApiKey)(sessionId);
|
|
476
|
-
res.send(getWelcomePageHtml(apiKey, tier, email));
|
|
481
|
+
res.send((0, welcome_page_js_1.getWelcomePageHtml)(apiKey, tier, email));
|
|
477
482
|
}
|
|
478
483
|
catch (err) {
|
|
479
484
|
console.error('Welcome page error:', err instanceof Error ? err.message : err);
|
|
@@ -770,6 +775,29 @@ async function startHttp() {
|
|
|
770
775
|
res.status(500).json({ error: 'Failed to load verify samples' });
|
|
771
776
|
}
|
|
772
777
|
});
|
|
778
|
+
// BOT-W2 / D1-C: bot validates api_keys it receives via /start auth_<key>
|
|
779
|
+
// deep-link from /welcome. Two-flag firewall reuses the W1 internal-bypass
|
|
780
|
+
// env (BOT_INTERNAL_BYPASS_ENABLED + ALGOVAULT_INTERNAL_BYPASS_KEY).
|
|
781
|
+
// NOT exposed via the MCP transport — this is a server-internal HTTP route.
|
|
782
|
+
app.get('/api/bot/validate-key', async (req, res) => {
|
|
783
|
+
const auth = (0, bot_auth_js_1.checkBotInternalAuth)(req.headers);
|
|
784
|
+
if (!auth.ok) {
|
|
785
|
+
return res.status(auth.status).json({ error: auth.error });
|
|
786
|
+
}
|
|
787
|
+
const apiKey = (req.query.api_key || '').trim();
|
|
788
|
+
if (!apiKey) {
|
|
789
|
+
return res.status(400).json({ error: 'api_key_required' });
|
|
790
|
+
}
|
|
791
|
+
const result = await (0, stripe_js_1.validateApiKey)(apiKey);
|
|
792
|
+
if (!result.valid || !result.tier) {
|
|
793
|
+
return res.status(404).json({ valid: false });
|
|
794
|
+
}
|
|
795
|
+
return res.json({
|
|
796
|
+
valid: true,
|
|
797
|
+
customer_id: result.customerId || null,
|
|
798
|
+
tier: result.tier,
|
|
799
|
+
});
|
|
800
|
+
});
|
|
773
801
|
// MCP endpoint
|
|
774
802
|
app.all('/mcp', express.json(), async (req, res) => {
|
|
775
803
|
// Resolve license per-request using 3-tier gate: x402 → API key → free
|
|
@@ -999,6 +1027,12 @@ function renderAssets(data) {
|
|
|
999
1027
|
// Canonical 20 Skill slugs — table renders all 20 even with zero invocations.
|
|
1000
1028
|
// Kept in sync with skills/manifest.json in github.com/AlgoVaultLabs/algovault-skills.
|
|
1001
1029
|
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'];
|
|
1030
|
+
// Canonical license tiers — Calls by Tier table renders all 5 even at zero
|
|
1031
|
+
// count, so operators can monitor enterprise + x402 traffic the moment it
|
|
1032
|
+
// starts (instead of "tier just appeared today" silent change). Order is
|
|
1033
|
+
// price-asc with x402 last (pay-per-call sits outside the subscription ladder).
|
|
1034
|
+
// Kept in sync with LicenseTier enum in src/types.ts.
|
|
1035
|
+
const LICENSE_TIERS = ['free','starter','pro','enterprise','x402'];
|
|
1002
1036
|
function escSlug(s) { return String(s).replace(/[<>&]/g,''); }
|
|
1003
1037
|
function fmtTs(s) {
|
|
1004
1038
|
if (!s) return '<span style="color:#6e7681">never</span>';
|
|
@@ -1039,7 +1073,12 @@ async function load() {
|
|
|
1039
1073
|
document.getElementById('sessions-all').textContent = d.uniqueSessions.allTime;
|
|
1040
1074
|
document.getElementById('sessions-24h').textContent = d.uniqueSessions.last24h;
|
|
1041
1075
|
renderRows('by-tool', d.byTool);
|
|
1042
|
-
|
|
1076
|
+
// Pre-fill all 5 canonical license tiers (zero-fill missing) so empty
|
|
1077
|
+
// buckets like enterprise + x402 always show as "0" rows. Mirrors the
|
|
1078
|
+
// SKILL_SLUGS pattern at line ~1066: explicit canonical-list expansion
|
|
1079
|
+
// beats "render whatever the API returns" for monitoring surfaces.
|
|
1080
|
+
const tierFilled = Object.fromEntries(LICENSE_TIERS.map(t => [t, (d.byTier && d.byTier[t]) || 0]));
|
|
1081
|
+
renderRows('by-tier', tierFilled);
|
|
1043
1082
|
renderAssets(d.topAssets);
|
|
1044
1083
|
// C1 (LATENCY-W1): truthful per-tool latency table — n / p50 / p95 / min / max.
|
|
1045
1084
|
// Replaces the misleading single-number avg (a bimodal distribution averaged 7.8s
|
|
@@ -1679,56 +1718,6 @@ function getSignupPageHtml() {
|
|
|
1679
1718
|
</body>
|
|
1680
1719
|
</html>`;
|
|
1681
1720
|
}
|
|
1682
|
-
// ── Welcome Page HTML ──
|
|
1683
|
-
function getWelcomePageHtml(apiKey, tier, email) {
|
|
1684
|
-
const keyDisplay = apiKey
|
|
1685
|
-
? `<div class="key-box"><div class="label">Your API Key</div><code id="api-key">${apiKey}</code><button onclick="navigator.clipboard.writeText(document.getElementById('api-key').textContent);this.textContent='Copied!'">Copy</button></div>`
|
|
1686
|
-
: `<div class="pending"><p>Your API key is being provisioned. This usually takes a few seconds.</p><p>Refresh this page in a moment, or check your email at <strong>${email || 'your registered address'}</strong>.</p></div>`;
|
|
1687
|
-
return `<!DOCTYPE html>
|
|
1688
|
-
<html lang="en">
|
|
1689
|
-
<head>
|
|
1690
|
-
<meta charset="utf-8">
|
|
1691
|
-
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
1692
|
-
<title>Welcome to AlgoVault ${tier ? `(${tier})` : ''}</title>
|
|
1693
|
-
<style>
|
|
1694
|
-
* { margin: 0; padding: 0; box-sizing: border-box; }
|
|
1695
|
-
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #0f1117; color: #e1e4e8; display: flex; justify-content: center; align-items: center; min-height: 100vh; padding: 24px; }
|
|
1696
|
-
.container { max-width: 560px; width: 100%; text-align: center; }
|
|
1697
|
-
h1 { font-size: 28px; margin-bottom: 8px; }
|
|
1698
|
-
.subtitle { color: #8b949e; margin-bottom: 32px; font-size: 14px; }
|
|
1699
|
-
.key-box { background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 24px; margin: 24px 0; text-align: left; }
|
|
1700
|
-
.key-box .label { color: #8b949e; font-size: 12px; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 12px; }
|
|
1701
|
-
.key-box code { display: block; background: #0d1117; border: 1px solid #21262d; border-radius: 6px; padding: 12px 16px; font-size: 16px; color: #3fb950; word-break: break-all; margin-bottom: 12px; }
|
|
1702
|
-
.key-box button { background: #238636; color: #fff; border: none; padding: 8px 20px; border-radius: 6px; cursor: pointer; font-size: 14px; }
|
|
1703
|
-
.key-box button:hover { background: #2ea043; }
|
|
1704
|
-
.pending { background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 24px; margin: 24px 0; color: #d29922; }
|
|
1705
|
-
.usage { margin-top: 24px; text-align: left; }
|
|
1706
|
-
.usage h2 { font-size: 16px; color: #8b949e; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 12px; }
|
|
1707
|
-
.usage pre { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; font-size: 13px; overflow-x: auto; color: #c9d1d9; }
|
|
1708
|
-
</style>
|
|
1709
|
-
</head>
|
|
1710
|
-
<body>
|
|
1711
|
-
<div class="container">
|
|
1712
|
-
<h1>Welcome to AlgoVault! 🎉</h1>
|
|
1713
|
-
<div class="subtitle">${tier ? tier.charAt(0).toUpperCase() + tier.slice(1) + ' plan activated' : 'Setting up your account...'}</div>
|
|
1714
|
-
${keyDisplay}
|
|
1715
|
-
<div class="usage">
|
|
1716
|
-
<h2>Use it in Claude Desktop / Cursor / Claude Code</h2>
|
|
1717
|
-
<pre>{
|
|
1718
|
-
"mcpServers": {
|
|
1719
|
-
"algovault": {
|
|
1720
|
-
"url": "https://api.algovault.com/mcp",
|
|
1721
|
-
"headers": { "Authorization": "Bearer ${apiKey || 'YOUR_API_KEY'}" }
|
|
1722
|
-
}
|
|
1723
|
-
}
|
|
1724
|
-
}</pre>
|
|
1725
|
-
<p style="color:#8b949e;font-size:12px;margin-top:8px">Paste into <code style="background:#0d1117;padding:1px 4px;border-radius:3px">claude_desktop_config.json</code> (or Cursor / Claude Code MCP config). Then ask: <em>"Get me a trade call for SOL on the 5-minute timeframe."</em></p>
|
|
1726
|
-
<p style="color:#8b949e;font-size:12px;margin-top:8px">Want to test with raw HTTP/curl? See the <a href="https://algovault.com/docs.html#testing-with-curl" style="color:#58a6ff">3-step handshake guide</a> in our docs. Supported exchanges: HL (default), BINANCE, BYBIT, OKX, BITGET. Need to find your key later? Visit <a href="/account" style="color:#58a6ff">/account</a>.</p>
|
|
1727
|
-
</div>
|
|
1728
|
-
</div>
|
|
1729
|
-
</body>
|
|
1730
|
-
</html>`;
|
|
1731
|
-
}
|
|
1732
1721
|
// ── Entry Point ──
|
|
1733
1722
|
const transport = (process.env.TRANSPORT || 'http').toLowerCase();
|
|
1734
1723
|
if (transport === 'stdio') {
|