omnitrade-mcp 0.7.5 → 0.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.
- package/README.md +153 -0
- package/dist/cli.js +1 -1
- package/dist/index.js +2002 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,6 +15,12 @@ Connect Claude to Binance, Coinbase, Kraken, and 104 more cryptocurrency exchang
|
|
|
15
15
|
- ⚡ **Arbitrage Detection** — Find price differences across exchanges
|
|
16
16
|
- 📊 **Unified Portfolio** — See all holdings in one view
|
|
17
17
|
- 🛡️ **Safety First** — Order limits, pair whitelists, testnet mode
|
|
18
|
+
- 🔔 **Price Alerts** — Get notified when crypto hits your target price
|
|
19
|
+
- 📈 **ASCII Charts** — View price history right in your terminal
|
|
20
|
+
- 📊 **Portfolio Tracking** — Track P&L over time with snapshots
|
|
21
|
+
- ⚖️ **Auto-Rebalance** — Automatically rebalance to target allocations
|
|
22
|
+
- 💰 **DCA (Dollar Cost Average)** — Set up recurring buys
|
|
23
|
+
- 🎯 **Conditional Orders** — Execute trades based on price conditions
|
|
18
24
|
|
|
19
25
|
## Quick Start
|
|
20
26
|
|
|
@@ -78,9 +84,16 @@ Restart Claude Desktop and start chatting:
|
|
|
78
84
|
- *"Show me ETH prices across all exchanges"*
|
|
79
85
|
- *"Buy $50 of BTC on the cheapest exchange"*
|
|
80
86
|
- *"Are there any arbitrage opportunities for SOL?"*
|
|
87
|
+
- *"Alert me when BTC drops below $40000"*
|
|
88
|
+
- *"Show me a 24h chart for ETH"*
|
|
89
|
+
- *"How has my portfolio performed this week?"*
|
|
90
|
+
- *"Rebalance my portfolio to 50% BTC, 30% ETH, 20% SOL"*
|
|
91
|
+
- *"Setup DCA to buy $10 of BTC daily"*
|
|
92
|
+
- *"Buy ETH if it drops 5%"*
|
|
81
93
|
|
|
82
94
|
## Available Tools
|
|
83
95
|
|
|
96
|
+
### Core Trading
|
|
84
97
|
| Tool | Description |
|
|
85
98
|
|------|-------------|
|
|
86
99
|
| `get_balances` | Get portfolio balances across exchanges |
|
|
@@ -90,9 +103,149 @@ Restart Claude Desktop and start chatting:
|
|
|
90
103
|
| `place_order` | Execute buy/sell orders |
|
|
91
104
|
| `get_orders` | View open and recent orders |
|
|
92
105
|
| `cancel_order` | Cancel an open order |
|
|
106
|
+
|
|
107
|
+
### Advanced Trading
|
|
108
|
+
| Tool | Description |
|
|
109
|
+
|------|-------------|
|
|
93
110
|
| `get_arbitrage` | Find arbitrage opportunities |
|
|
111
|
+
| `execute_arbitrage` | Execute arbitrage trades automatically |
|
|
94
112
|
| `check_spread` | Check spread for a specific pair |
|
|
95
113
|
|
|
114
|
+
### Alerts
|
|
115
|
+
| Tool | Description |
|
|
116
|
+
|------|-------------|
|
|
117
|
+
| `set_price_alert` | Set price alerts for any trading pair |
|
|
118
|
+
| `list_alerts` | View all active and triggered alerts |
|
|
119
|
+
| `check_alerts` | Manually check if alerts have triggered |
|
|
120
|
+
| `remove_alert` | Remove a specific alert |
|
|
121
|
+
| `clear_triggered_alerts` | Clear alert history |
|
|
122
|
+
|
|
123
|
+
### Charts & Analytics
|
|
124
|
+
| Tool | Description |
|
|
125
|
+
|------|-------------|
|
|
126
|
+
| `get_chart` | Display ASCII price charts (1h, 4h, 24h, 7d) |
|
|
127
|
+
| `record_portfolio_snapshot` | Record current portfolio value |
|
|
128
|
+
| `get_portfolio_history` | View portfolio P&L over time |
|
|
129
|
+
| `clear_portfolio_history` | Clear portfolio history |
|
|
130
|
+
|
|
131
|
+
### Portfolio Management
|
|
132
|
+
| Tool | Description |
|
|
133
|
+
|------|-------------|
|
|
134
|
+
| `rebalance_portfolio` | Auto-rebalance to target allocations |
|
|
135
|
+
|
|
136
|
+
### DCA (Dollar Cost Averaging)
|
|
137
|
+
| Tool | Description |
|
|
138
|
+
|------|-------------|
|
|
139
|
+
| `setup_dca` | Setup recurring buy orders |
|
|
140
|
+
| `list_dca_configs` | List all DCA configurations |
|
|
141
|
+
| `execute_dca_orders` | Execute pending DCA orders |
|
|
142
|
+
| `toggle_dca` | Enable/disable DCA configs |
|
|
143
|
+
| `remove_dca` | Remove DCA configuration |
|
|
144
|
+
|
|
145
|
+
### Conditional Orders
|
|
146
|
+
| Tool | Description |
|
|
147
|
+
|------|-------------|
|
|
148
|
+
| `set_conditional_order` | Create price-triggered orders |
|
|
149
|
+
| `list_conditional_orders` | View all conditional orders |
|
|
150
|
+
| `check_conditional_orders` | Check and execute conditions |
|
|
151
|
+
| `remove_conditional_order` | Remove conditional order |
|
|
152
|
+
|
|
153
|
+
## Usage Examples
|
|
154
|
+
|
|
155
|
+
### Price Alerts
|
|
156
|
+
```
|
|
157
|
+
You: "Alert me when BTC drops below $40000"
|
|
158
|
+
Claude: ✅ Alert set for BTC/USDT below $40000
|
|
159
|
+
|
|
160
|
+
You: "Check my alerts"
|
|
161
|
+
Claude: 🚨 1 alert triggered! BTC has gone below $40000 on binance
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
### ASCII Charts
|
|
165
|
+
```
|
|
166
|
+
You: "Show me a 24h chart for ETH"
|
|
167
|
+
Claude:
|
|
168
|
+
╔════════════════════════════════════════════════════════════╗
|
|
169
|
+
║ ETH/USDT - 24h Chart ║
|
|
170
|
+
╠════════════════════════════════════════════════════════════╣
|
|
171
|
+
█
|
|
172
|
+
▄█
|
|
173
|
+
██▄
|
|
174
|
+
███▄
|
|
175
|
+
████▄
|
|
176
|
+
╚════════════════════════════════════════════════════════════╝
|
|
177
|
+
Start: $3245.20 | End: $3312.50 | Change: ↑ 2.07% ($67.30)
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### Portfolio History & P&L
|
|
181
|
+
```
|
|
182
|
+
You: "Record my portfolio value"
|
|
183
|
+
Claude: ✅ Portfolio snapshot recorded: $12,345.67
|
|
184
|
+
|
|
185
|
+
You: "How has my portfolio performed this week?"
|
|
186
|
+
Claude:
|
|
187
|
+
Performance (1w):
|
|
188
|
+
Start: $10,000.00
|
|
189
|
+
End: $12,345.67
|
|
190
|
+
Profit: ↑ $2,345.67 (23.46%)
|
|
191
|
+
Trend: UP
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
### Auto-Rebalance
|
|
195
|
+
```
|
|
196
|
+
You: "Rebalance my portfolio to 50% BTC, 30% ETH, 20% SOL"
|
|
197
|
+
Claude:
|
|
198
|
+
📊 Rebalance Plan:
|
|
199
|
+
Current: BTC 40%, ETH 35%, SOL 25%
|
|
200
|
+
Target: BTC 50%, ETH 30%, SOL 20%
|
|
201
|
+
|
|
202
|
+
Trades required:
|
|
203
|
+
- BUY 0.0523 BTC ($1,234.56)
|
|
204
|
+
- SELL 0.1234 ETH ($456.78)
|
|
205
|
+
- SELL 5.6789 SOL ($234.56)
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
### DCA (Dollar Cost Averaging)
|
|
209
|
+
```
|
|
210
|
+
You: "Setup DCA to buy $10 of BTC every day"
|
|
211
|
+
Claude: ✅ DCA strategy created for BTC/USDT: $10 daily
|
|
212
|
+
|
|
213
|
+
You: "Execute my DCA orders"
|
|
214
|
+
Claude: DCA execution complete: 1 succeeded, 0 failed
|
|
215
|
+
- Bought 0.00024 BTC for $10.00
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### Conditional Orders
|
|
219
|
+
```
|
|
220
|
+
You: "Buy ETH if it drops 5%"
|
|
221
|
+
Claude: ✅ Conditional order created
|
|
222
|
+
When: ETH price decreases by 5% (from $3,245.20)
|
|
223
|
+
Will execute: MARKET BUY 0.5 ETH
|
|
224
|
+
|
|
225
|
+
You: "Check conditional orders"
|
|
226
|
+
Claude: 🚨 1 conditional order triggered!
|
|
227
|
+
ETH dropped to $3,082.94 (-5.0%)
|
|
228
|
+
Executed: MARKET BUY 0.5 ETH (Order #12345)
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
### Arbitrage Execution
|
|
232
|
+
```
|
|
233
|
+
You: "Find arbitrage for BTC"
|
|
234
|
+
Claude: Found 1 opportunity:
|
|
235
|
+
Buy BTC on Kraken: $42,150
|
|
236
|
+
Sell BTC on Binance: $42,300
|
|
237
|
+
Spread: 0.36% ($150)
|
|
238
|
+
|
|
239
|
+
You: "Execute arbitrage for 0.01 BTC between Kraken and Binance"
|
|
240
|
+
Claude:
|
|
241
|
+
📊 Arbitrage Preview:
|
|
242
|
+
Buy on Kraken: $421.50
|
|
243
|
+
Sell on Binance: $423.00
|
|
244
|
+
Gross profit: $1.50 (0.36%)
|
|
245
|
+
Fees: $0.84
|
|
246
|
+
Net profit: $0.66 (0.16%)
|
|
247
|
+
```
|
|
248
|
+
|
|
96
249
|
## Supported Exchanges
|
|
97
250
|
|
|
98
251
|
OmniTrade supports **107 exchanges** through [CCXT](https://github.com/ccxt/ccxt), including:
|
package/dist/cli.js
CHANGED
|
@@ -5,7 +5,7 @@ import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
|
|
|
5
5
|
import { homedir } from "os";
|
|
6
6
|
import { join } from "path";
|
|
7
7
|
import * as readline from "readline";
|
|
8
|
-
var VERSION = "0.
|
|
8
|
+
var VERSION = "0.8.0";
|
|
9
9
|
var CONFIG_PATH = join(homedir(), ".omnitrade", "config.json");
|
|
10
10
|
var c = {
|
|
11
11
|
reset: "\x1B[0m",
|