|
1 | 1 | --- |
2 | 2 | name: fintool |
3 | | -description: "Financial trading CLI — spot/perp/options trading on Hyperliquid, Binance, Coinbase. LLM-enriched price quotes with trend analysis. Prediction markets (Polymarket + Kalshi). News and SEC filings. Use when: user asks about stock/crypto prices, wants to trade, check portfolio, or browse prediction markets." |
| 3 | +description: "Financial trading CLI — spot/perp/options trading on Hyperliquid, Binance, Coinbase. Deposit and withdraw across chains (Unit bridge, Across Protocol). LLM-enriched price quotes with trend analysis. Prediction markets (Polymarket + Kalshi). News and SEC filings. Use when: user asks about stock/crypto prices, wants to trade, deposit, withdraw, check portfolio, or browse prediction markets." |
4 | 4 | homepage: https://github.com/second-state/fintool |
5 | 5 | metadata: { "openclaw": { "emoji": "📈", "requires": { "bins": ["curl"] } } } |
6 | 6 | --- |
@@ -49,6 +49,8 @@ cat ~/.fintool/config.toml 2>/dev/null |
49 | 49 | | Spot orders | ✅ | ✅ | ✅ | |
50 | 50 | | Perp orders | ✅ | ✅ | ❌ | |
51 | 51 | | Options | ❌ | ✅ | ❌ | |
| 52 | +| Deposit | ✅ (Unit + Across) | ✅ (API) | ✅ (API) | |
| 53 | +| Withdraw | ✅ (Bridge2 + Unit + Across) | ✅ (API) | ✅ (API) | |
52 | 54 | | Balance | ✅ | ✅ | ✅ | |
53 | 55 | | Open orders | ✅ | ✅ | ✅ | |
54 | 56 | | Cancel | ✅ | ✅ | ✅ | |
@@ -209,6 +211,86 @@ Returns: mark price, oracle price, funding rate, open interest, premium, max lev |
209 | 211 | {baseDir}/scripts/fintool cancel coinbase:uuid-here # Coinbase |
210 | 212 | ``` |
211 | 213 |
|
| 214 | +### Workflow 6: Depositing Funds |
| 215 | + |
| 216 | +**Goal**: Fund an exchange account with crypto from an external wallet or another chain. |
| 217 | + |
| 218 | +**Hyperliquid — ETH/BTC/SOL (permanent deposit address via HyperUnit):** |
| 219 | +```bash |
| 220 | +{baseDir}/scripts/fintool deposit ETH |
| 221 | +{baseDir}/scripts/fintool deposit BTC |
| 222 | +{baseDir}/scripts/fintool deposit SOL |
| 223 | +``` |
| 224 | +Returns a reusable deposit address on the native chain. User sends any amount, any time. |
| 225 | + |
| 226 | +**Hyperliquid — USDC from Ethereum or Base (automated bridge):** |
| 227 | +```bash |
| 228 | +# Bridge 100 USDC from Ethereum mainnet → Hyperliquid |
| 229 | +{baseDir}/scripts/fintool deposit USDC --amount 100 --from ethereum |
| 230 | + |
| 231 | +# Bridge 500 USDC from Base → Hyperliquid |
| 232 | +{baseDir}/scripts/fintool deposit USDC --amount 500 --from base |
| 233 | + |
| 234 | +# Preview the route and fees without executing |
| 235 | +{baseDir}/scripts/fintool deposit USDC --amount 100 --from ethereum --dry-run |
| 236 | +``` |
| 237 | +Automatically signs 3 transactions: approval → Across bridge → HL Bridge2 deposit. |
| 238 | + |
| 239 | +**Binance — get deposit address:** |
| 240 | +```bash |
| 241 | +{baseDir}/scripts/fintool deposit USDC --exchange binance --from ethereum |
| 242 | +{baseDir}/scripts/fintool deposit ETH --exchange binance |
| 243 | +{baseDir}/scripts/fintool deposit BTC --exchange binance --from bitcoin |
| 244 | +``` |
| 245 | + |
| 246 | +**Coinbase — get deposit address:** |
| 247 | +```bash |
| 248 | +{baseDir}/scripts/fintool deposit ETH --exchange coinbase |
| 249 | +{baseDir}/scripts/fintool deposit USDC --exchange coinbase |
| 250 | +``` |
| 251 | + |
| 252 | +### Workflow 7: Withdrawing Funds |
| 253 | + |
| 254 | +**Goal**: Move assets from an exchange to an external wallet or another chain. |
| 255 | + |
| 256 | +**Hyperliquid — USDC to Arbitrum (default, ~3-4 min):** |
| 257 | +```bash |
| 258 | +{baseDir}/scripts/fintool withdraw 100 USDC |
| 259 | +{baseDir}/scripts/fintool withdraw 100 USDC --to 0xOtherAddress |
| 260 | +``` |
| 261 | + |
| 262 | +**Hyperliquid — USDC to Ethereum or Base (chained bridge, ~5-7 min):** |
| 263 | +```bash |
| 264 | +{baseDir}/scripts/fintool withdraw 100 USDC --network ethereum |
| 265 | +{baseDir}/scripts/fintool withdraw 100 USDC --network base |
| 266 | +{baseDir}/scripts/fintool withdraw 100 USDC --network ethereum --dry-run |
| 267 | +``` |
| 268 | +Automatically chains: HL Bridge2 → Arbitrum → Across bridge → destination. |
| 269 | + |
| 270 | +**Hyperliquid — ETH/BTC/SOL to native chain (via HyperUnit):** |
| 271 | +```bash |
| 272 | +{baseDir}/scripts/fintool withdraw 0.5 ETH |
| 273 | +{baseDir}/scripts/fintool withdraw 0.01 BTC --to bc1q... |
| 274 | +{baseDir}/scripts/fintool withdraw 1 SOL --to SomeSolanaAddress |
| 275 | +``` |
| 276 | + |
| 277 | +**Binance:** |
| 278 | +```bash |
| 279 | +{baseDir}/scripts/fintool withdraw 100 USDC --to 0x... --exchange binance --network ethereum |
| 280 | +{baseDir}/scripts/fintool withdraw 0.5 ETH --to 0x... --exchange binance --network arbitrum |
| 281 | +``` |
| 282 | + |
| 283 | +**Coinbase:** |
| 284 | +```bash |
| 285 | +{baseDir}/scripts/fintool withdraw 100 USDC --to 0x... --exchange coinbase |
| 286 | +{baseDir}/scripts/fintool withdraw 0.5 ETH --to 0x... --exchange coinbase --network base |
| 287 | +``` |
| 288 | + |
| 289 | +**Track HyperUnit bridge operations:** |
| 290 | +```bash |
| 291 | +{baseDir}/scripts/fintool bridge-status |
| 292 | +``` |
| 293 | + |
212 | 294 | ## Symbol Aliases |
213 | 295 |
|
214 | 296 | Common indices and commodities have convenient aliases: |
|
0 commit comments