FinClaw
Enables trading and data retrieval from Binance exchange, including real-time quotes and funding rates.
Supports data and trading on Coinbase exchange.
Integrates with OKX exchange for crypto trading and funding rates.
Allows using local AI models via Ollama for financial analysis and strategy generation.
Allows using OpenAI models for AI copilot and strategy generation.
Provides historical and real-time US stock market data via Polygon.io.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FinClawget quote for AAPL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
$ finclaw quote AAPL
AAPL $252.82 +2.31 +0.92%
Bid: 252.82 Ask: 252.83 Vol: 30,091,880
$ finclaw analyze TSLA --indicators rsi,macd,bollinger
๐ฌ Technical Analysis: TSLA
Price: $175.21 | 52w High: $299.29 | 52w Low: $138.80
RSI(14) 62.4 NEUTRAL momentum balanced
MACD +4.82 BULLISH histogram expanding
Bollinger 72%B NEUTRAL upper half of band
$ finclaw backtest -t NVDA --start 2023-01-01
๐ NVDA | momentum
Return: +142.3% (+55.2%/yr) | Alpha: +18.7%
MaxDD: -12.1% | Sharpe: 1.85 | Trades: 47Why FinClaw?
Most quant tools make you configure databases, install heavy dependencies, and write boilerplate before you see your first result. FinClaw gets you from zero to insight in one command. Zero API keys needed โ it uses Yahoo Finance by default. A pure NumPy core means it installs in seconds, not minutes. And when you're ready for AI-powered strategy generation, MCP agent integration, or multi-exchange live trading โ it's all built in.
Related MCP server: tradingview-mcp
Quick Start
pip install finclaw-ai
finclaw demo # See all features โ no API key needed
finclaw quote AAPL # Real-time stock quote
finclaw copilot # AI financial assistantFeature Comparison
Feature | FinClaw | Backtrader | Zipline | Freqtrade |
Zero-config install | โ | โ | โ | โ |
CLI interface | โ | โ | โ | โ |
AI strategy generation | โ | โ | โ | โ |
Natural language copilot | โ | โ | โ | โ |
MCP server (AI agents) | โ | โ | โ | โ |
A2A protocol | โ | โ | โ | โ |
Paper trading | โ | โ | โ | โ |
Backtesting | โ | โ | โ | โ |
Multi-exchange (12+) | โ | โ | โ | โ |
Strategy plugins | โ | โ | โ | โ |
No heavy deps (pure NumPy) | โ | โ | โ | โ |
Crypto + Stocks + CN Stocks | โ | โ | โ | โ * |
Terminal charts | โ | โ | โ | โ |
YAML strategy DSL | โ | โ | โ | โ |
BTC on-chain metrics | โ | โ | โ | โ |
Funding rate dashboard | โ | โ | โ | โ |
Lightning Network monitor | โ | โ | โ | โ |
What You Can Do
๐ Quotes & Analysis
finclaw quote AAPL,MSFT,NVDA # Multi-ticker quotes
finclaw analyze TSLA --indicators rsi,macd,bollinger,sma50
finclaw chart AAPL --type candle # Terminal candlestick chart
finclaw news AAPL # Financial news
finclaw sentiment TSLA # Sentiment analysis๐ Backtesting
finclaw backtest -t AAPL,MSFT --strategy momentum --start 2023-01-01
finclaw backtest -t NVDA --benchmark SPY # Compare to benchmark
finclaw strategy list # 20+ built-in strategies
finclaw strategy backtest trend-following --symbol AAPL๐ Paper Trading
finclaw paper start --balance 100000
finclaw paper buy AAPL 50
finclaw paper sell MSFT 20
finclaw paper dashboard
finclaw paper run-strategy golden-cross --symbols AAPL,MSFT๐ค AI Features
# Generate strategies from plain English or ไธญๆ
finclaw generate-strategy "buy when RSI < 30 and MACD golden cross"
finclaw generate-strategy --market crypto --risk high "momentum on volume spike"
# Interactive AI assistant
finclaw copilot
> ๅๆ็นๆฏๆๆ่ฟ่ตฐๅฟ
> ๅธฎๆๅๅปบไธไธชๅๅผๅๅฝ็ญ็ฅ
# AI-optimize existing strategies
finclaw optimize-strategy my_strategy.py --data AAPL --period 1ySupports: OpenAI, Anthropic, DeepSeek, Gemini, Ollama (local), Groq, Mistral, Moonshot.
โ๏ธ BTC Metrics & Crypto Tools
finclaw btc-metrics # On-chain dashboard (hashrate, MVRV, miner outflow)
finclaw funding-rates # Multi-exchange funding rate comparison + arbitrage
finclaw fear-greed --history 7 # Fear & Greed Index with historyFeatures:
BTC On-Chain Metrics โ Hashrate, difficulty, mempool, MVRV ratio, miner outflow (via Blockchain.info)
Multi-Exchange Funding Dashboard โ Binance, Bybit, OKX funding rates with arbitrage detection
Lightning Network Monitor โ Network capacity, node count, channel stats (via 1ML.com)
Fear & Greed Index โ Current and historical data (via Alternative.me)
Liquidation Tracker โ Track liquidation events across exchanges
On-Chain Analytics โ Transaction volume, active addresses
๐ MCP Server (for AI Agents)
Expose FinClaw as tools for Claude, Cursor, VS Code, or OpenClaw:
{
"mcpServers": {
"finclaw": {
"command": "finclaw",
"args": ["mcp", "serve"]
}
}
}10 MCP tools available: get_quote, get_history, list_exchanges, run_backtest, analyze_portfolio, get_indicators, screen_stocks, get_sentiment, compare_strategies, get_funding_rates.
๐ Strategy Plugin Ecosystem
# Create a plugin in 5 minutes
finclaw init-strategy my_strategy
cd finclaw-strategy-my_strategy
pip install -e .
finclaw backtest --strategy plugin:my_strategy -t AAPL
# Or use YAML DSL
finclaw strategy create # Interactive builder
finclaw strategy dsl-backtest my_strategy.yaml --symbol AAPL
finclaw strategy optimize my_strategy.yaml --param rsi_period:10:30:5Compatible with Backtrader strategies, TA-Lib indicators, and basic Pine Script.
๐ 12+ Exchange Adapters
Crypto: Binance, Bybit, OKX, Coinbase, Kraken (with WebSocket for Binance/Bybit/OKX) US Stocks: Yahoo Finance, Alpaca, Polygon, Alpha Vantage CN Stocks: AkShare, BaoStock, Tushare
finclaw exchanges list # See all adapters
finclaw exchanges compare yahoo binance alpaca
finclaw quote BTCUSDT --exchange binance
finclaw history ETHUSDT --exchange bybit --timeframe 1h --limit 50๐ค A2A Protocol (Agent-to-Agent)
FinClaw implements the A2A protocol for inter-agent communication:
finclaw a2a serve --port 8081 # Start A2A server
finclaw a2a card # Print agent cardPython API
from finclaw import FinClaw
fc = FinClaw()
# Quote
quote = fc.quote("AAPL")
print(f"AAPL: ${quote['price']:.2f} ({quote['change_pct']:+.1f}%)")
# Backtest
result = fc.backtest(strategy="momentum", ticker="NVDA", start="2023-01-01")
print(f"Return: {result.total_return:.1%} | Sharpe: {result.sharpe_ratio:.2f}")Full API documentation: docs/API.md
Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ User Interfaces โ
โ CLI โ MCP Server โ A2A โ Copilot โ API โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ AI Strategy Engine โ
โ Generator โ Optimizer โ Copilot Chat โ Pine DSL โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Strategy Layer โ
โ Built-in (20+) โ Plugins โ YAML DSL โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Backtester โ Paper Trading โ Risk Engine โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Data Layer โ
โ Yahoo โ Binance WS โ 12+ Exchanges โ Cache โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Crypto Layer โ
โ BTC Metrics โ Funding Rates โ Lightning โ DeFi โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโExamples
See examples/ for runnable strategies:
simple_momentum.py โ SMA + RSI momentum strategy
crypto_rsi.py โ Crypto RSI oversold/overbought
ai_generated.py โ BB squeeze mean reversion (AI-generated)
python examples/simple_momentum.py AAPL
python examples/crypto_rsi.py BTC-USD
python examples/ai_generated.py TSLAContributing
git clone https://github.com/NeuZhou/finclaw.git
cd finclaw && pip install -e ".[dev]"
pytestSee CONTRIBUTING.md for guidelines.
License
๐ NeuZhou Ecosystem
FinClaw is part of the NeuZhou open source toolkit for AI agents:
Project | What it does | Link |
repo2skill | Convert any repo into an AI agent skill | |
ClawGuard | Security scanner for AI agents | |
AgentProbe | Behavioral testing framework for agents | |
FinClaw | AI-powered financial intelligence engine | You are here |
The workflow: Generate skills with repo2skill โ Scan for vulnerabilities with ClawGuard โ Test behavior with AgentProbe โ See it in action with FinClaw.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/IlyasFardaouix/finclaw'
If you have feedback or need assistance with the MCP directory API, please join our Discord server