{"id":31556129,"url":"https://github.com/jongan69/trading-api","last_synced_at":"2025-10-04T22:49:04.829Z","repository":{"id":309031827,"uuid":"1034949937","full_name":"jongan69/trading-api","owner":"jongan69","description":"A Rust Market Data API","archived":false,"fork":false,"pushed_at":"2025-09-03T19:12:16.000Z","size":287,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-03T21:21:16.675Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://trading-api-wcv5.onrender.com/docs","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jongan69.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-09T10:30:11.000Z","updated_at":"2025-09-03T19:12:17.000Z","dependencies_parsed_at":"2025-08-09T12:22:38.946Z","dependency_job_id":"80261b6b-d534-435a-807e-2c249695bfcc","html_url":"https://github.com/jongan69/trading-api","commit_stats":null,"previous_names":["jongan69/trading-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jongan69/trading-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Ftrading-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Ftrading-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Ftrading-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Ftrading-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jongan69","download_url":"https://codeload.github.com/jongan69/trading-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Ftrading-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278386119,"owners_count":25978109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-04T22:49:02.681Z","updated_at":"2025-10-04T22:49:04.822Z","avatar_url":"https://github.com/jongan69.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Trading API MCP Server\n\nA comprehensive **Model Context Protocol (MCP) server** that exposes powerful market research tools to AI agents. Built on top of a robust Rust trading API that aggregates data from multiple financial sources including traditional markets, cryptocurrencies, DeFi protocols, Solana ecosystem, and meme tokens.\n\n## 🌟 Features\n\n- **40+ Market Research Tools** for AI agents via MCP\n- **Multi-Source Data Aggregation**: Stocks, crypto, DeFi, NFTs, meme tokens, news, sentiment, options\n- **Real-Time Market Data** from 15+ sources including Reddit, Finviz, CoinGecko, Kraken, Yahoo Finance, Hyperliquid, Pump.fun, Helius\n- **Comprehensive Analysis** combining traditional and DeFi markets\n- **Solana Ecosystem Integration** with NFT and token analytics\n- **DeFi Protocol Support** including Hyperliquid derivatives\n- **Meme Token Analysis** via Pump.fun integration\n- **Production-Ready** with error handling, caching, rate limiting, and comprehensive documentation\n- **Trading Capabilities** for Kraken and Alpaca (paper trading)\n\n## 🚀 Quick Start\n\n```bash\n# 1. Setup (one time)\n./setup_mcp.sh\n\n# 2. Start services\ncargo run                    # Terminal 1: Rust API\nsource venv/bin/activate     # Terminal 2: Python env\npython mcp_server.py         # Terminal 2: MCP server\n\n# 3. Test everything works\npython test_mcp.py\n```\n\n## 🛠️ MCP Tools Available\n\n### Core Market Analysis Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_comprehensive_market_analysis` | Complete market overview across all sources | Overall market research |\n| `get_trending_stocks` | Hot stocks from Reddit, Finviz, and other sources | Trend identification |\n| `get_trending_crypto` | Trending cryptocurrencies from multiple sources | Crypto market analysis |\n| `get_market_news` | Aggregated financial news from multiple sources | Sentiment analysis |\n| `get_reddit_trending_stocks` | Reddit sentiment analysis with social indicators | Social media trends |\n| `search_market_data` | Search across all data sources | Targeted research |\n\n### Traditional Finance Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_yahoo_metrics` | Stock metrics, ratios, and financial data | Fundamental analysis |\n| `get_finviz_data` | Forex, futures, insider trading data | Traditional markets |\n| `get_high_open_interest` | Options contracts with high open interest | Institutional sentiment |\n\n### Cryptocurrency Exchange Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_coingecko_data` | Comprehensive crypto data and market overview | Detailed crypto research |\n| `get_coingecko_market_context` | AI-powered market insights from CoinGecko | Market intelligence |\n| `get_coingecko_trending_symbols` | Trending crypto symbols | Opportunity identification |\n| `get_coingecko_gainers_losers` | Top crypto gainers and losers | Momentum analysis |\n| `get_kraken_ticker` | Real-time crypto prices from Kraken | Live market data |\n| `get_kraken_orderbook` | Kraken orderbook depth analysis | Liquidity analysis |\n| `get_kraken_ohlc` | OHLC candlestick data for technical analysis | Price action analysis |\n| `get_kraken_recent_trades` | Recent trading activity | Market momentum |\n| `get_kraken_assets` | Available Kraken trading assets | Asset discovery |\n\n### DeFi Protocol Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_hyperliquid_markets` | All Hyperliquid perpetual markets | DeFi derivatives analysis |\n| `get_hyperliquid_trending` | Trending DeFi assets on Hyperliquid | Hot DeFi opportunities |\n| `get_hyperliquid_top_volume` | Highest volume Hyperliquid markets | Activity analysis |\n| `get_hyperliquid_movers` | Top DeFi gainers and losers | Momentum tracking |\n| `get_hyperliquid_funding` | Perpetual funding rates | Market sentiment |\n| `get_hyperliquid_market_data` | Specific asset market data | Deep asset analysis |\n| `get_hyperliquid_overview` | Complete Hyperliquid market overview | DeFi market intelligence |\n\n### Solana Ecosystem Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_solana_asset` | Detailed Solana asset information | Asset research |\n| `get_solana_trending_nfts` | Trending Solana NFT collections | NFT market analysis |\n| `get_solana_trending_tokens` | Trending Solana tokens | DeFi token discovery |\n| `get_solana_top_collections` | Top NFT collections by metrics | NFT investment research |\n| `get_solana_wallet_holdings` | Wallet portfolio analysis | Whale watching |\n| `search_solana_assets` | Search assets by various criteria | Targeted Solana research |\n\n### Meme Token \u0026 Pump.fun Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_pumpfun_trending` | Trending pump.fun meme tokens | Memecoin analysis |\n| `get_pumpfun_token_info` | Detailed token information | Token due diligence |\n| `get_pumpfun_market_summary` | Pump.fun market overview | Meme market intelligence |\n| `search_pumpfun_tokens` | Search for specific meme tokens | Token discovery |\n| `get_pumpfun_new_tokens` | Newly launched tokens | Fresh opportunity identification |\n| `get_pumpfun_gainers_losers` | Top meme token movers | Momentum analysis |\n| `get_pumpfun_bonding_curve` | Token bonding curve economics | Tokenomics analysis |\n\n### System \u0026 Monitoring Tools\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `get_system_health` | API system health status | Monitoring |\n| `get_system_metrics` | Performance metrics | System analysis |\n\n## 🤖 AI Agent Integration\n\n### Claude Desktop\nAdd to your MCP configuration:\n```json\n{\n  \"mcpServers\": {\n    \"trading-api\": {\n      \"command\": \"python\",\n      \"args\": [\"/path/to/trading-api/mcp_server.py\"],\n      \"transport\": \"stdio\"\n    }\n  }\n}\n```\n\n### Research Agents (LangChain)\n```python\nfrom langchain_mcp_adapters.client import MultiServerMCPClient\n\nmcp_config = {\n    \"trading_api\": {\n        \"command\": \"python\",\n        \"args\": [\"/path/to/trading-api/mcp_server.py\"],\n        \"transport\": \"stdio\"\n    }\n}\n\nclient = MultiServerMCPClient(mcp_config)\ntools = await client.get_tools()\n```\n\n## 📊 Example AI Research Queries\n\n### Traditional Markets\n- *\"Give me a comprehensive analysis of current market conditions\"*\n- *\"What are the top trending stocks and what's driving their movement?\"*\n- *\"Analyze Tesla across all data sources - news, sentiment, technicals\"*\n- *\"What is the options market telling us about institutional positioning?\"*\n- *\"Show me insider trading activity and high open interest options\"*\n\n### Cryptocurrency \u0026 DeFi\n- *\"What are the hottest DeFi opportunities on Hyperliquid right now?\"*\n- *\"Compare Bitcoin funding rates across perpetual markets\"*\n- *\"Show me trending Solana tokens with high volume\"*\n- *\"Analyze the correlation between traditional crypto and DeFi markets\"*\n- *\"What's driving the current crypto market sentiment?\"*\n\n### Meme Tokens \u0026 Emerging Markets\n- *\"Find newly launched meme tokens on pump.fun with strong momentum\"*\n- *\"Analyze bonding curve economics for trending pump.fun tokens\"*\n- *\"What are the top Solana NFT collections by volume today?\"*\n- *\"Show me whale wallet activity in the Solana ecosystem\"*\n\n### Cross-Market Analysis\n- *\"How are traditional stocks correlating with crypto markets today?\"*\n- *\"Compare meme token performance against traditional crypto\"*\n- *\"Identify arbitrage opportunities between centralized and DeFi markets\"*\n- *\"Analyze market sentiment across Reddit, news, and on-chain data\"*\n\n## 🏗️ Architecture\n\n```\nAI Agent \u003c--MCP--\u003e Python MCP Server \u003c--HTTP--\u003e Rust Trading API \u003c--\u003e Data Sources\n                                                      |\n                                                      ├── Traditional Finance\n                                                      │   ├── Yahoo Finance\n                                                      │   ├── Finviz  \n                                                      │   ├── Reddit\n                                                      │   └── Alpaca\n                                                      │\n                                                      ├── Cryptocurrency\n                                                      │   ├── CoinGecko\n                                                      │   ├── Kraken\n                                                      │   └── Helius\n                                                      │\n                                                      ├── DeFi Protocols\n                                                      │   └── Hyperliquid\n                                                      │\n                                                      ├── Solana Ecosystem\n                                                      │   ├── Helius API\n                                                      │   ├── Jito\n                                                      │   └── Direct RPC\n                                                      │\n                                                      └── Meme Tokens\n                                                          └── Pump.fun\n```\n\n### Components\n- **Rust API**: High-performance data aggregation with caching, rate limiting, and error handling\n- **Python MCP Server**: Standards-compliant MCP interface with 40+ specialized tools\n- **Data Sources**: 15+ integrated sources spanning traditional finance, crypto, DeFi, and emerging markets\n- **Trading Integration**: Paper and live trading capabilities via Kraken and Alpaca\n- **Caching Layer**: Intelligent caching to optimize API calls and reduce latency\n- **Monitoring**: Built-in health checks and performance metrics\n\n## 📁 Repository Structure\n\n```\ntrading-api/\n├── src/                          # Rust trading API source code\n│   ├── routes/                   # API endpoint handlers\n│   │   ├── data.rs              # Traditional market data\n│   │   ├── coingecko.rs         # CoinGecko crypto data\n│   │   ├── kraken.rs            # Kraken exchange\n│   │   ├── hyperliquid.rs       # DeFi derivatives\n│   │   ├── solana.rs            # Solana ecosystem\n│   │   ├── pumpfun.rs           # Meme token data\n│   │   ├── yahoo.rs             # Yahoo Finance\n│   │   ├── options.rs           # Options analysis\n│   │   ├── high_open_interest.rs # High OI analysis\n│   │   └── system.rs            # Health \u0026 monitoring\n│   ├── sources/                 # Data source integrations\n│   │   ├── finviz_data.rs       # Finviz scraping\n│   │   ├── reddit_data.rs       # Reddit sentiment\n│   │   ├── yahoo_data.rs        # Yahoo Finance API\n│   │   ├── coingecko_data.rs    # CoinGecko API\n│   │   ├── kraken_data.rs       # Kraken API\n│   │   ├── hyperliquid_data.rs  # Hyperliquid API\n│   │   ├── helius_data.rs       # Solana data via Helius\n│   │   ├── pumpfun_data.rs      # Pump.fun integration\n│   │   ├── alpaca_data.rs       # Options data\n│   │   └── jito_data.rs         # Jito MEV data\n│   ├── helpers/                 # Analysis and aggregation logic\n│   │   ├── trending_stocks.rs   # Stock trend analysis\n│   │   ├── trending_cryptos.rs  # Crypto trend analysis\n│   │   ├── news.rs              # News aggregation\n│   │   ├── metrics.rs           # Performance metrics\n│   │   └── options.rs           # Options analysis\n│   ├── trading/                 # Trading execution modules\n│   │   ├── kraken_trading.rs    # Kraken trading\n│   │   └── alpaca_trading.rs    # Alpaca trading\n│   ├── middleware/              # HTTP middleware\n│   ├── types.rs                 # Type definitions\n│   ├── errors.rs                # Error handling\n│   ├── config.rs                # Configuration management\n│   ├── cache.rs                 # Caching layer\n│   └── lib.rs                   # Main library\n├── examples/                     # Usage examples\n│   ├── coingecko_example.rs     # CoinGecko integration\n│   ├── kraken_example.rs        # Kraken integration\n│   ├── high_open_interest_example.rs # Options analysis\n│   └── trending_options_example.rs   # Trending analysis\n├── docs/                        # Comprehensive documentation\n│   ├── API_DOCUMENTATION.md    # Complete API reference\n│   ├── QUICK_START.md           # Quick setup guide\n│   ├── MCP_SERVER_README.md     # MCP server details\n│   ├── PRODUCTION_READINESS.md  # Production deployment\n│   └── TROUBLESHOOTING.md       # Common issues\n├── tests/                       # Test suites\n│   ├── integration_tests.rs     # Integration tests\n│   └── e2e.rs                   # End-to-end tests\n├── mcp_server.py                # MCP server implementation (40+ tools)\n├── research_agent_example.py    # AI research agent example\n├── requirements.txt             # Python dependencies\n├── setup_mcp.sh                 # Automated setup script\n├── test_mcp.py                  # MCP server test suite\n├── Cargo.toml                   # Rust dependencies\n└── README.md                    # This comprehensive guide\n```\n\n## 🔧 Installation \u0026 Setup\n\n### Prerequisites\n- Rust 1.70+\n- Python 3.8+\n- pip and virtual environment support\n\n### Automated Setup\n```bash\n# Clone and setup everything\ngit clone \u003cyour-repo\u003e\ncd trading-api\n./setup_mcp.sh\n```\n\n### Manual Setup\n```bash\n# Rust dependencies\ncargo build\n\n# Python environment\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\n```\n\n## 🧪 Testing\n\n```bash\n# Test Rust API\ncargo test\n\n# Test MCP server integration\npython test_mcp.py\n\n# Test with sample research queries\npython research_agent_example.py\n```\n\n## 📝 Environment Variables\n\nCreate a `.env` file:\n```bash\n# API Keys (optional, for enhanced data)\nREDDIT_CLIENT_ID=your_reddit_client_id\nREDDIT_CLIENT_SECRET=your_reddit_client_secret\nALPHAVANTAGE_API_KEY=your_alphavantage_key\n\n# Server Configuration\nSERVER_HOST=localhost\nSERVER_PORT=3000\n\n# For research agent example\nOPENAI_API_KEY=your_openai_key\nANTHROPIC_API_KEY=your_anthropic_key\n```\n\n## 🚦 API Endpoints (Rust Server)\n\nThe Rust API provides comprehensive endpoints organized by category:\n\n### System \u0026 Health\n- `GET /health` - System health check\n- `GET /metrics` - Performance metrics\n- `GET /docs` - Interactive API documentation (Swagger UI)\n\n### Traditional Markets\n- `GET /trending/stocks` - Trending stocks from multiple sources\n- `GET /reddit/stocks` - Reddit sentiment analysis\n- `GET /news` - Aggregated financial news\n- `GET /yahoo/metrics` - Yahoo Finance stock metrics\n- `GET /forex` - Forex market data (Finviz)\n- `GET /insider` - Insider trading activity\n- `GET /high-open-interest` - High open interest options\n\n### Cryptocurrency Exchanges\n- `GET /trending/crypto` - Trending cryptocurrencies\n- `GET /coingecko/top` - Top cryptocurrencies (CoinGecko)\n- `GET /coingecko/trending` - Trending crypto symbols\n- `GET /coingecko/gainers` - Top crypto gainers\n- `GET /coingecko/losers` - Top crypto losers\n- `GET /coingecko/market-context` - AI-powered market insights\n- `GET /kraken/ticker` - Kraken ticker data\n- `GET /kraken/orderbook/{pair}` - Orderbook depth\n- `GET /kraken/ohlc/{pair}` - OHLC candlestick data\n- `GET /kraken/trades/{pair}` - Recent trades\n- `GET /kraken/assets` - Available trading assets\n\n### DeFi Protocols\n- `GET /hyperliquid/markets` - All Hyperliquid markets\n- `GET /hyperliquid/trending` - Trending DeFi assets\n- `GET /hyperliquid/volume/top` - Highest volume markets\n- `GET /hyperliquid/movers` - Top gainers/losers\n- `GET /hyperliquid/funding` - Funding rates\n- `GET /hyperliquid/market/{coin}` - Specific market data\n- `GET /hyperliquid/stats/overview` - Market overview\n\n### Solana Ecosystem\n- `GET /solana/asset/{asset_id}` - Asset details\n- `GET /solana/nfts/trending` - Trending NFT collections\n- `GET /solana/tokens/trending` - Trending tokens\n- `GET /solana/collections/top` - Top NFT collections\n- `GET /solana/wallet/{address}/holdings` - Wallet analysis\n- `GET /solana/assets/search` - Asset search\n\n### Meme Tokens (Pump.fun)\n- `GET /pumpfun/trending` - Trending meme tokens\n- `GET /pumpfun/token/{mint}` - Token details\n- `GET /pumpfun/market-summary` - Market overview\n- `GET /pumpfun/search/{query}` - Token search\n- `GET /pumpfun/new-tokens` - Newly launched tokens\n- `GET /pumpfun/top-gainers` - Top gaining tokens\n- `GET /pumpfun/top-losers` - Top losing tokens\n- `GET /pumpfun/bonding-curve/{mint}` - Bonding curve data\n\n**📖 Complete Documentation:** Available at `http://localhost:3000/docs` when running the server.\n**🔍 OpenAPI Spec:** Available at `http://localhost:3000/openapi.json`\n\n## 🔍 Data Sources\n\n### Traditional Finance\n| Source | Data Type | Update Frequency | Features |\n|--------|-----------|------------------|----------|\n| **Yahoo Finance** | Stock prices, metrics, financial ratios | Real-time/Daily | Comprehensive stock analysis |\n| **Finviz** | Stocks, forex, futures, insider trading | Real-time | Market screening, insider activity |\n| **Reddit** | Social sentiment, trending discussions | Real-time | Social sentiment analysis |\n| **Alpaca** | Options data, high open interest | Real-time | Options market intelligence |\n\n### Cryptocurrency Exchanges  \n| Source | Data Type | Update Frequency | Features |\n|--------|-----------|------------------|----------|\n| **CoinGecko** | Crypto prices, market data, trending | Real-time | Comprehensive crypto analytics |\n| **Kraken** | Exchange data, orderbooks, trades | Real-time | Professional trading data |\n\n### DeFi Protocols\n| Source | Data Type | Update Frequency | Features |\n|--------|-----------|------------------|----------|\n| **Hyperliquid** | Perpetual markets, funding rates | Real-time | DeFi derivatives intelligence |\n\n### Solana Ecosystem\n| Source | Data Type | Update Frequency | Features |\n|--------|-----------|------------------|----------|\n| **Helius** | NFTs, tokens, wallet analysis | Real-time | Comprehensive Solana data |\n| **Jito** | MEV data, block analysis | Real-time | MEV and validator insights |\n| **Direct RPC** | On-chain data, program accounts | Real-time | Raw blockchain data |\n\n### Meme Tokens \u0026 Emerging Markets\n| Source | Data Type | Update Frequency | Features |\n|--------|-----------|------------------|----------|\n| **Pump.fun** | Meme tokens, bonding curves | Real-time | Complete meme token ecosystem |\n\n### Data Quality \u0026 Reliability\n- **Redundancy**: Multiple sources for critical data points\n- **Validation**: Cross-source data validation and consistency checks  \n- **Fallback**: Graceful degradation when sources are unavailable\n- **Rate Limiting**: Intelligent rate limiting to respect API limits\n- **Caching**: Smart caching to reduce API calls and improve performance\n\n## 🛡️ Security \u0026 Performance\n\n### Performance Optimizations\n- **Intelligent Caching**: Multi-layer caching system with TTL-based invalidation\n- **Connection Pooling**: Efficient HTTP connection management\n- **Concurrent Processing**: Async/await throughout for maximum throughput\n- **Rate Limiting**: Adaptive rate limiting per data source\n- **Request Batching**: Batch similar requests to reduce API calls\n- **Response Compression**: Gzip compression for API responses\n\n### Security Features\n- **Input Validation**: Comprehensive validation of all user inputs\n- **Sanitization**: Data sanitization to prevent injection attacks\n- **CORS Protection**: Configurable CORS policies\n- **Error Handling**: Secure error messages without information leakage\n- **API Key Management**: Secure handling of external API credentials\n- **Request Logging**: Comprehensive request/response logging for audit trails\n\n### Reliability \u0026 Monitoring\n- **Health Checks**: Built-in health monitoring for all components\n- **Circuit Breakers**: Automatic circuit breakers for failing services\n- **Graceful Degradation**: Continue operating with reduced functionality\n- **Metrics Collection**: Performance metrics and analytics\n- **Error Recovery**: Automatic retry logic with exponential backoff\n- **Service Discovery**: Dynamic service endpoint management\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support \u0026 Troubleshooting\n\n### Common Issues\n\n**\"Failed to connect to API\"**\n- Ensure Rust API is running: `cargo run`\n- Check port 3000 is available: `curl http://localhost:3000/health`\n\n**\"Tool not found\"**\n- Verify MCP server is running: `python mcp_server.py`\n- Check tool names match exactly\n\n**\"Authentication errors\"**\n- Set API keys in `.env` file\n- For research agent example, set `OPENAI_API_KEY` and `ANTHROPIC_API_KEY`\n\n### Getting Help\n\n- 📖 Check the documentation in this README\n- 🧪 Run the test suite: `python test_mcp.py`\n- 🔍 Check server logs for detailed error information\n- 📝 Review the example integration: `research_agent_example.py`\n\n## 🎯 What You Get\n\n✅ **Production-ready MCP server** with 40+ specialized market research tools  \n✅ **Comprehensive market coverage** across traditional finance, crypto, DeFi, and emerging markets  \n✅ **Multi-source data aggregation** from 15+ major financial platforms  \n✅ **Real-time market intelligence** with intelligent caching and rate limiting  \n✅ **Solana ecosystem integration** including NFTs, tokens, and wallet analysis  \n✅ **DeFi protocol support** with Hyperliquid derivatives and funding rates  \n✅ **Meme token analytics** via Pump.fun integration with bonding curve analysis  \n✅ **Trading capabilities** for both paper and live trading (Kraken, Alpaca)  \n✅ **Easy AI integration** with any MCP-compatible system (Claude, LangChain, etc.)  \n✅ **Comprehensive documentation** with examples, troubleshooting, and production guides  \n✅ **Automated setup** with testing tools and health monitoring  \n✅ **Enterprise-ready** with error handling, logging, metrics, and security features  \n\n### 🚀 Transform Your AI Agents Into:\n- **Sophisticated Market Researchers** with access to traditional and emerging markets\n- **DeFi Intelligence Analysts** tracking derivatives and funding rates\n- **Meme Token Specialists** analyzing bonding curves and social sentiment  \n- **Cross-Market Arbitrage Detectors** identifying opportunities across ecosystems\n- **Portfolio Analysts** with wallet tracking and whale watching capabilities\n- **News \u0026 Sentiment Analyzers** combining social media and traditional news sources\n\n**Ready to revolutionize your AI trading and research capabilities?** This comprehensive trading API MCP server provides everything you need to build intelligent, data-driven trading agents that understand both traditional and emerging financial markets.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongan69%2Ftrading-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjongan69%2Ftrading-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongan69%2Ftrading-api/lists"}