crypto-quant-signal-mcp 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/README.md +51 -22
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +393 -91
  4. package/dist/index.js.map +1 -1
  5. package/dist/lib/adapters/binance.d.ts +23 -0
  6. package/dist/lib/adapters/binance.d.ts.map +1 -0
  7. package/dist/lib/adapters/binance.js +177 -0
  8. package/dist/lib/adapters/binance.js.map +1 -0
  9. package/dist/lib/adapters/bitget.d.ts +19 -0
  10. package/dist/lib/adapters/bitget.d.ts.map +1 -0
  11. package/dist/lib/adapters/bitget.js +155 -0
  12. package/dist/lib/adapters/bitget.js.map +1 -0
  13. package/dist/lib/adapters/bybit.d.ts +19 -0
  14. package/dist/lib/adapters/bybit.d.ts.map +1 -0
  15. package/dist/lib/adapters/bybit.js +151 -0
  16. package/dist/lib/adapters/bybit.js.map +1 -0
  17. package/dist/lib/adapters/okx.d.ts +19 -0
  18. package/dist/lib/adapters/okx.d.ts.map +1 -0
  19. package/dist/lib/adapters/okx.js +196 -0
  20. package/dist/lib/adapters/okx.js.map +1 -0
  21. package/dist/lib/exchange-adapter.d.ts +8 -4
  22. package/dist/lib/exchange-adapter.d.ts.map +1 -1
  23. package/dist/lib/exchange-adapter.js +30 -6
  24. package/dist/lib/exchange-adapter.js.map +1 -1
  25. package/dist/lib/license.d.ts +29 -2
  26. package/dist/lib/license.d.ts.map +1 -1
  27. package/dist/lib/license.js +115 -7
  28. package/dist/lib/license.js.map +1 -1
  29. package/dist/lib/merkle.d.ts +16 -0
  30. package/dist/lib/merkle.d.ts.map +1 -0
  31. package/dist/lib/merkle.js +76 -0
  32. package/dist/lib/merkle.js.map +1 -0
  33. package/dist/lib/performance-db.d.ts +29 -6
  34. package/dist/lib/performance-db.d.ts.map +1 -1
  35. package/dist/lib/performance-db.js +224 -19
  36. package/dist/lib/performance-db.js.map +1 -1
  37. package/dist/lib/stripe.d.ts.map +1 -1
  38. package/dist/lib/stripe.js +3 -0
  39. package/dist/lib/stripe.js.map +1 -1
  40. package/dist/lib/telegram.d.ts +7 -0
  41. package/dist/lib/telegram.d.ts.map +1 -0
  42. package/dist/lib/telegram.js +55 -0
  43. package/dist/lib/telegram.js.map +1 -0
  44. package/dist/resources/signal-performance.d.ts.map +1 -1
  45. package/dist/resources/signal-performance.js +3 -3
  46. package/dist/resources/signal-performance.js.map +1 -1
  47. package/dist/scripts/agent-forum-post.d.ts +18 -0
  48. package/dist/scripts/agent-forum-post.d.ts.map +1 -0
  49. package/dist/scripts/agent-forum-post.js +604 -0
  50. package/dist/scripts/agent-forum-post.js.map +1 -0
  51. package/dist/scripts/backfill-outcomes.js +127 -80
  52. package/dist/scripts/backfill-outcomes.js.map +1 -1
  53. package/dist/scripts/deploy-merkle-contract.d.ts +3 -0
  54. package/dist/scripts/deploy-merkle-contract.d.ts.map +1 -0
  55. package/dist/scripts/deploy-merkle-contract.js +26 -0
  56. package/dist/scripts/deploy-merkle-contract.js.map +1 -0
  57. package/dist/scripts/molthunt-launch.d.ts +11 -0
  58. package/dist/scripts/molthunt-launch.d.ts.map +1 -0
  59. package/dist/scripts/molthunt-launch.js +234 -0
  60. package/dist/scripts/molthunt-launch.js.map +1 -0
  61. package/dist/scripts/monitor.d.ts +3 -0
  62. package/dist/scripts/monitor.d.ts.map +1 -0
  63. package/dist/scripts/monitor.js +305 -0
  64. package/dist/scripts/monitor.js.map +1 -0
  65. package/dist/scripts/publish-merkle-batch.d.ts +14 -0
  66. package/dist/scripts/publish-merkle-batch.d.ts.map +1 -0
  67. package/dist/scripts/publish-merkle-batch.js +93 -0
  68. package/dist/scripts/publish-merkle-batch.js.map +1 -0
  69. package/dist/scripts/seed-signals.d.ts +12 -16
  70. package/dist/scripts/seed-signals.d.ts.map +1 -1
  71. package/dist/scripts/seed-signals.js +194 -48
  72. package/dist/scripts/seed-signals.js.map +1 -1
  73. package/dist/tools/get-market-regime.d.ts +3 -1
  74. package/dist/tools/get-market-regime.d.ts.map +1 -1
  75. package/dist/tools/get-market-regime.js +23 -10
  76. package/dist/tools/get-market-regime.js.map +1 -1
  77. package/dist/tools/get-trade-signal.d.ts +2 -1
  78. package/dist/tools/get-trade-signal.d.ts.map +1 -1
  79. package/dist/tools/get-trade-signal.js +58 -18
  80. package/dist/tools/get-trade-signal.js.map +1 -1
  81. package/dist/tools/scan-funding-arb.d.ts.map +1 -1
  82. package/dist/tools/scan-funding-arb.js +26 -8
  83. package/dist/tools/scan-funding-arb.js.map +1 -1
  84. package/dist/types.d.ts +3 -0
  85. package/dist/types.d.ts.map +1 -1
  86. package/package.json +12 -2
  87. package/server.json +3 -3
package/README.md CHANGED
@@ -4,13 +4,14 @@
4
4
 
5
5
  # crypto-quant-signal-mcp
6
6
 
7
- The signal intelligence layer for AI trading agents — composite quant signals across crypto and TradFi perps, cross-venue arbitrage detection, and regime-aware market classification via MCP.
7
+ The call intelligence 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.
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
10
10
  [![npm downloads](https://img.shields.io/npm/dw/crypto-quant-signal-mcp)](https://www.npmjs.com/package/crypto-quant-signal-mcp)
11
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)
12
13
 
13
- **[Live Track Record](https://algovault.com/track-record)** — 90%+ directional accuracy across 900+ trade calls. Public, no login required.
14
+ **[Live Track Record](https://algovault.com/track-record)** — 91%+ directional accuracy across 19,000+ trade calls on 5 exchanges. Public, no login required.
14
15
 
15
16
  ---
16
17
 
@@ -18,16 +19,16 @@ The signal intelligence layer for AI trading agents — composite quant signals
18
19
 
19
20
  Most MCP trading servers give you raw data — prices, order books, candles. Your agent still has to figure out what to do with it.
20
21
 
21
- AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score, built from a multi-factor composite scoring engine tuned on production quant systems. Every signal is tracked, every outcome is measured, and the full track record is public from day one.
22
+ AlgoVault is different. We give your agent **one answer**: a directional verdict with a confidence score, built from a multi-factor composite scoring engine tuned on production quant systems. Every call is tracked, every outcome is measured, and the full track record is public from day one.
22
23
 
23
24
  **What makes this not just another indicator wrapper:**
24
25
 
25
26
  - **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.
26
- - **Regime-aware signal generation.** Signals are filtered through a market regime classifier before emission. The engine knows when to signal and when to stay silent — a trend-following setup in a ranging market gets suppressed, not broadcast.
27
- - **Cross-venue intelligence.** Funding rates from Hyperliquid, Binance, and Bybit are normalized and compared in real-time. Nobody else does cross-venue derivatives analysis via MCP.
28
- - **Published track record with every release.** Every signal is recorded with outcome prices at multiple horizons. Win rate, profit factor, and expected value are computed continuously. No cherry-picking, no survivorship bias.
29
- - **Adaptive scoring.** Indicator weights are retuned monthly from outcome data. The engine learns what works and adjusts — the signal you get today is better than the one from last month.
30
- - **Crypto + TradFi coverage.** 290+ assets — standard crypto perps, TradFi perpetuals (stocks, indices, commodities, FX via Hyperliquid's xyz dex), and liquidity-filtered meme coins. Assets are classified into quality tiers with institutional-grade signal filtering.
27
+ - **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.
28
+ - **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.
29
+ - **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.
30
+ - **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.
31
+ - **Crypto + TradFi coverage.** 290+ 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.
31
32
 
32
33
  ---
33
34
 
@@ -50,6 +51,8 @@ No code. No API key. No install.
50
51
 
51
52
  > "Get me a trade signal for ETH on the 4h timeframe"
52
53
 
54
+ > "Get me a trade signal for BTC on Binance, 1h timeframe"
55
+
53
56
  ![BTC Signal Result](https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/BTC-signal.png)
54
57
 
55
58
  That's it. Your Claude now has a quant analyst built in.
@@ -60,22 +63,23 @@ That's it. Your Claude now has a quant analyst built in.
60
63
 
61
64
  ### `get_trade_signal`
62
65
 
63
- Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset — crypto perps, TradFi perpetuals (stocks, indices, commodities, FX), and liquidity-filtered meme coins on Hyperliquid.
66
+ Returns a composite **BUY / SELL / HOLD** verdict with confidence score for any supported asset on any of 5 supported exchanges — crypto perps, TradFi perpetuals (stocks, indices, commodities, FX), and liquidity-filtered meme coins on Hyperliquid.
64
67
 
65
68
  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 — including funding flow analysis, volatility regime detection, and trend persistence decay — before a final verdict is emitted.
66
69
 
67
- Only high-conviction signals are generated. The engine is designed to stay silent when the edge is unclear.
70
+ Only high-conviction calls are generated. The engine is designed to stay silent when the edge is unclear.
68
71
 
69
72
  **Parameters:**
70
73
  - `coin` (string, required): Asset symbol — e.g. `"ETH"`, `"BTC"`, `"SOL"`, `"GOLD"`, `"TSLA"`, or any of 290+ supported assets
71
74
  - `timeframe` (string, default `"15m"`): `"1m"`, `"3m"`, `"5m"`, `"15m"`, `"30m"`, `"1h"`, `"2h"`, `"4h"`, `"8h"`, `"12h"`, `"1d"`
72
- - `includeReasoning` (boolean, default `true`): Human-readable explanation of the signal logic
75
+ - `exchange` (string, default `"HL"`): `"HL"` (Hyperliquid), `"BINANCE"`, `"BYBIT"`, `"OKX"`, `"BITGET"`. TradFi assets (GOLD, TSLA, etc.) are HL-only.
76
+ - `includeReasoning` (boolean, default `true`): Human-readable explanation of the call logic
73
77
 
74
- **Output includes:** signal direction, confidence score (0–100), all computed indicator values, detected market regime, reasoning narrative, and `_algovault` metadata for downstream tool composability.
78
+ **Output includes:** call direction, confidence score (0–100), all computed indicator values, detected market regime, reasoning narrative, and `_algovault` metadata for downstream tool composability.
75
79
 
76
80
  ### `scan_funding_arb`
77
81
 
78
- 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).
82
+ 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.
79
83
 
80
84
  This is the only MCP server that provides cross-venue funding arbitrage intelligence — long one exchange, short another, capture the spread.
81
85
 
@@ -94,6 +98,7 @@ Uses a multi-dimensional classification approach combining directional strength
94
98
  **Parameters:**
95
99
  - `coin` (string, required): Asset symbol
96
100
  - `timeframe` (string, default `"4h"`): Candle timeframe for analysis
101
+ - `exchange` (string, default `"HL"`): Exchange to analyze — same options as get_trade_signal
97
102
 
98
103
  **Output includes:** regime label, confidence score, underlying metrics (trend strength, volatility interpretation, price structure), cross-venue funding sentiment, and a plain-English strategy suggestion.
99
104
 
@@ -101,20 +106,34 @@ Uses a multi-dimensional classification approach combining directional strength
101
106
 
102
107
  ## Performance Tracking
103
108
 
104
- Every signal is tracked from emission to outcome. No exceptions.
109
+ Every call is tracked from emission to outcome. No exceptions.
105
110
 
106
111
  **What we measure:**
107
112
  - Outcome prices at timeframe-appropriate evaluation windows
108
- - PFE Win Rate — did price move in the signal direction at any point during the evaluation window
109
- - Expected Value — probability-weighted average return per signal
113
+ - PFE Win Rate — did price move in the call direction at any point during the evaluation window
114
+ - Expected Value — probability-weighted average return per call
110
115
  - Profit Factor — gross wins divided by gross losses
111
116
  - Peak Favorable Excursion (PFE) and Maximum Adverse Excursion (MAE)
112
117
  - Running statistics per asset, timeframe, and quality tier
113
118
 
119
+ **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.
120
+
121
+ - **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.
122
+
114
123
  **Infrastructure:**
115
124
  - Remote mode: PostgreSQL with automated outcome backfill
116
125
  - Local mode: SQLite at `~/.crypto-quant-signal/performance.db`
117
- - Only high-confidence BUY/SELL signals are tracked — HOLD is excluded
126
+ - Only high-confidence BUY/SELL calls are tracked — HOLD is excluded
127
+ - Signals are tracked per exchange — the track record shows performance on each venue independently
128
+
129
+ ### On-Chain Verification
130
+
131
+ 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.
132
+
133
+ - **Contract**: [`0x6485...0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) (Base L2)
134
+ - **Verify any call**: `https://api.algovault.com/api/verify-signal?signalId=<ID>`
135
+ - **View all batches**: `https://api.algovault.com/api/merkle-batches`
136
+ - **Visual verification**: [algovault.com/verify](https://algovault.com/verify)
118
137
 
119
138
  ---
120
139
 
@@ -122,6 +141,7 @@ Every signal is tracked from emission to outcome. No exceptions.
122
141
 
123
142
  | Feature | Free | Starter ($9.99/mo) | Pro ($49/mo) | Enterprise ($299/mo) | x402 (per call) |
124
143
  |---------|------|-------------------|-------------|---------------------|-----------------|
144
+ | Exchanges | HL only | All 5 | All 5 | All 5 | All 5 |
125
145
  | Assets | BTC, ETH | All 290+ | All 290+ | All 290+ | All 290+ |
126
146
  | Asset classes | Crypto only | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi | Crypto + TradFi |
127
147
  | Timeframes | 15m, 1h | All 11 | All 11 | All 11 | All 11 |
@@ -130,6 +150,9 @@ Every signal is tracked from emission to outcome. No exceptions.
130
150
  | Monthly calls | ~100/day | 3,000/mo | 15,000/mo | 100,000/mo | Unlimited |
131
151
  | Support | Community | Email | Priority | Dedicated | — |
132
152
  | Price | $0 | $9.99/mo | $49/mo | $299/mo | $0.01–0.05/call |
153
+ | HOLD calls | Free | Free | Free | Free | Free |
154
+
155
+ \* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction.
133
156
 
134
157
  **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).
135
158
 
@@ -210,15 +233,19 @@ MCP Server (Express + @modelcontextprotocol/sdk)
210
233
  │ └─ Liquidity filter for meme/micro assets
211
234
  │
212
235
  ├─ Exchange Adapter Layer
213
- │ └─ Hyperliquid (standard + xyz TradFi perps) · Binance, Bybit (funding data)
236
+ │ ├─ Hyperliquid (crypto + TradFi xyz perps)
237
+ │ ├─ Binance USDT-M Futures
238
+ │ ├─ Bybit Linear
239
+ │ ├─ OKX Swap
240
+ │ └─ Bitget USDT-M
214
241
  │
215
242
  ├─ Performance Tracker
216
243
  │ └─ PostgreSQL (remote) / SQLite (local)
217
244
  │
218
- └─ Hyperliquid Public API (free, no auth)
245
+ └─ Exchange Public APIs (free, no auth — all 5 venues)
219
246
  ```
220
247
 
221
- **Exchange adapter pattern:** All exchange interactions go through the `ExchangeAdapter` interface — supporting both standard crypto perps and xyz TradFi perps on Hyperliquid, with Binance and Bybit for cross-venue funding comparison.
248
+ **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.
222
249
 
223
250
  ---
224
251
 
@@ -238,7 +265,7 @@ Schemas are designed for composability. All tools share consistent `timestamp`,
238
265
 
239
266
  ## Privacy
240
267
 
241
- **Local mode:** Zero telemetry. No data sent to AlgoVault servers. Signal history stored on your machine only.
268
+ **Local mode:** Zero telemetry. No data sent to AlgoVault servers. Call history stored on your machine only.
242
269
 
243
270
  **Remote mode:** Request metadata logged for analytics (IP hashed, never stored raw). See [privacy policy](https://api.algovault.com/privacy).
244
271
 
@@ -250,6 +277,8 @@ MIT
250
277
 
251
278
  ---
252
279
 
253
- Built by [AlgoVault Labs](https://algovault.com) — signal intelligence for the autonomous trading era.
280
+ > **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.
281
+
282
+ Built by [AlgoVault Labs](https://algovault.com)
254
283
 
255
284
  [Landing page](https://algovault.com) · [API endpoint](https://api.algovault.com/mcp)
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAk7BpE,wBAAgB,mBAAmB,cAElC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwtCpE,wBAAgB,mBAAmB,cAElC"}