{"id":28738466,"url":"https://github.com/rosendolu/crypto-mcp-server","last_synced_at":"2025-10-10T19:32:48.066Z","repository":{"id":299223934,"uuid":"985111364","full_name":"rosendolu/crypto-mcp-server","owner":"rosendolu","description":"A powerful MCP for cryptocurrency market data, cross-platform trading, arbitrage, kline (candlestick) analysis, portfolio analysis, and more. Supports multi-exchange, multi-account, and advanced multi-strategy analytics (MACD, Bollinger Bands, KDJ, EMA, etc.).","archived":false,"fork":false,"pushed_at":"2025-06-20T14:22:17.000Z","size":3084,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T03:12:55.385Z","etag":null,"topics":["binance","crypto-trading","cryptocurrency","gate","mcp-server"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/crypto-mcp-server","language":"TypeScript","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/rosendolu.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-05-17T04:58:14.000Z","updated_at":"2025-09-20T19:52:18.000Z","dependencies_parsed_at":"2025-06-15T12:59:41.057Z","dependency_job_id":"d4cb89f1-caea-4b21-a7fc-d23dc17976bc","html_url":"https://github.com/rosendolu/crypto-mcp-server","commit_stats":null,"previous_names":["rosendolu/crypto-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rosendolu/crypto-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rosendolu%2Fcrypto-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rosendolu%2Fcrypto-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rosendolu%2Fcrypto-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rosendolu%2Fcrypto-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rosendolu","download_url":"https://codeload.github.com/rosendolu/crypto-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rosendolu%2Fcrypto-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001951,"owners_count":26083244,"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-09T02:00:07.460Z","response_time":59,"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":["binance","crypto-trading","cryptocurrency","gate","mcp-server"],"created_at":"2025-06-16T04:15:11.767Z","updated_at":"2025-10-10T19:32:48.060Z","avatar_url":"https://github.com/rosendolu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚧 Crypto MCP CLI (Actively in Development!)\n\n[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord\u0026logoColor=white)](https://discord.gg/mJ8cdaJ5rg) [![Telegram](https://img.shields.io/badge/Telegram-Join%20Us-229ED9?logo=telegram\u0026logoColor=white)](https://t.me/crypto_mcp)\n\n🇨🇳 **中文用户请查看[中文文档](./docs/README.zh-CN.md)**\n\n\u003e ⚠️ **This project is under active development! Features, APIs, and documentation are rapidly evolving. Feedback and contributions are welcome.**\n\nA powerful MCP for cryptocurrency market data, cross-platform trading, arbitrage, kline (candlestick) analysis, portfolio analysis, and more. **Supports multi-exchange, multi-account, and advanced multi-strategy analytics (MACD, Bollinger Bands, KDJ, EMA, etc.)**. Built on CCXT for robust exchange integration.\n\n## ✨ Features\n\n-   🏦 **Multi-Exchange:** Trade and analyze on all major certified exchanges CCXT powered)\n-   🔄 **Arbitrage:** Cross-exchange arbitrage and analytics\n-   📈 **Kline/Candlestick Analysis:** Advanced OHLCV and indicator analytics (MACD, Bollinger Bands, KDJ, EMA, and more)\n-   📊 **Portfolio \u0026 Position Analysis:** Unified multi-exchange portfolio view\n-   🤖 **Automated Trading \u0026 Technical Analysis:** Strategy-driven, multi-account, multi-symbol\n\n## 🛠️ Tools\n\n![prompts usage](docs/usage.gif)\n\n\u003e 📚 **Prompt Templates Available!**\n\u003e\n\u003e For each tool, you can use ready-made English and Chinese prompt templates to interact with the CLI or compatible clients. See [`docs/tool-prompts.md`](./docs/tool-prompts.md) for a full list of prompt examples and parameter explanations.\n\u003e\n\u003e Example:\n\u003e\n\u003e -   English: `Get the latest price for ETH/USDT on binance.`\n\u003e -   中文: `查询 binance 上 ETH/USDT 的最新价格。`\n\nThe CLI provides the following tools (all exchange-agnostic, powered by CCXT:\n\n-   `prices` — Get current price(s) for a symbol or all symbols\n    -   Parameters: `symbol?`, `exchange?`\n-   `bookTickers` — Get best bid/ask for a symbol or all symbols\n    -   Parameters: `symbol?`, `exchange?`\n-   `prevDay` — Get 24h ticker stats for a symbol or all symbols\n    -   Parameters: `symbol?`, `exchange?`\n-   `candlesticks` — Get OHLCV candlestick data\n    -   Parameters: `symbol`, `interval`, `options?`, `exchange?`\n-   `balance` — Get account balance\n    -   Parameters: `exchange?`\n-   `dustLog` — Get dust conversion log (Binance only)\n    -   Parameters: `exchange?`\n-   `buy` — Place a limit buy order\n    -   Parameters: `symbol`, `quantity`, `price`, `options?`, `exchange?`\n-   `sell` — Place a limit sell order\n    -   Parameters: `symbol`, `quantity`, `price`, `options?`, `exchange?`\n-   `marketBuy` — Place a market buy order\n    -   Parameters: `symbol`, `quantity`, `options?`, `exchange?`\n-   `marketSell` — Place a market sell order\n    -   Parameters: `symbol`, `quantity`, `options?`, `exchange?`\n-   `orderStatus` — Get order status\n    -   Parameters: `symbol`, `orderId`, `exchange?`\n-   `allOrders` — Get all orders for a symbol\n    -   Parameters: `symbol`, `exchange?`\n-   `openOrders` — Get open orders for a symbol\n    -   Parameters: `symbol`, `exchange?`\n-   `cancel` — Cancel an order\n    -   Parameters: `symbol`, `orderId`, `exchange?`\n-   `cancelAll` — Cancel all open orders for a symbol\n    -   Parameters: `symbol`, `exchange?`\n-   `trades` — Get recent trades for a symbol\n    -   Parameters: `symbol`, `exchange?`\n-   `checkExchangeConfigs` — Check all supported exchanges for API key/secret config\n    -   No parameters\n-   `analyzeLogs` — Analyze system logs\n    -   Parameters: `date?`, `search?`, `limit?`\n\n## 🚀 Getting Started\n\n**If you find this project useful, please [star⭐️ us on GitHub](https://github.com/rosendolu/crypto-mcp-server)! Your support helps us grow and improve.**\n\n### Usage\n\n#### 1️⃣ Get Your Exchange API Key \u0026 Secret\n\nTo use the MCP server, you need API credentials from your exchange account (e.g., Binance, Gate, etc.).\n\nIf you don't have an account yet:\n\n\u003e Don't have an account? Click to sign up now\n\n[\u003cimg src=\"docs/icons/binance.png\" alt=\"Binance\" width=\"28\" style=\"vertical-align:middle;background:#000\"/\u003e Binance](https://www.marketwebb.net/activity/referral-entry/CPA?ref=CPA_00568KAJ11)  \n [\u003cimg src=\"docs/icons/gate.png\" alt=\"Gate\" width=\"28\" style=\"vertical-align:middle;background:#000;\"/\u003e Gate](https://www.gateweb.space/signup/AVFAVws?ref_type=103)\n\nAfter registering, create an API key and secret in your exchange account dashboard.\n\n\u003e To place an order, write permission is required.\n\n#### 2️⃣ Add the MCP Tool\n\nThe CLI can be used directly with an MCP-compatible client, such as **Cursor**, **Claude**, that supports stdio transport:\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=Crypto%20MCP%20Server\u0026config=eyJjb21tYW5kIjoibnB4IC15IGNyeXB0by1tY3Atc2VydmVyIiwiZW52Ijp7IkJJTkFOQ0VfQVBJX0tFWSI6IiIsIkJJTkFOQ0VfU0VDUkVUIjoiIiwiR0FURV9BUElfS0VZIjoiIiwiR0FURV9TRUNSRVQiOiIifX0%3D)\n\n```json\n{\n    \"Crypto MCP Server\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"crypto-mcp-server\"],\n        \"env\": {\n            \"BINANCE_API_KEY\": \"\",\n            \"BINANCE_SECRET\": \"\",\n            \"GATE_API_KEY\": \"\",\n            \"GATE_SECRET\": \"\"\n        }\n    }\n}\n```\n\n### Environment Variables\n\n```\n# Example for Binance\nBINANCE_API_KEY=your_binance_api_key\nBINANCE_SECRET=your_binance_secret\n\n# Example for OKX\nOKX_API_KEY=your_okx_api_key\nOKX_SECRET=your_okx_secret\n\n# Example for Gate\nGATE_API_KEY=your_gate_api_key\nGATE_SECRET=your_gate_secret\n\n# ...repeat for each supported exchange below\n```\n\n#### Supported Exchanges (CCXT Certified)\n\n-   binance\n-   binancecoinm\n-   binanceusdm\n-   bingx\n-   bitget\n-   bitmart\n-   bitmex\n-   bybit\n-   coinex\n-   cryptocom\n-   gate\n-   hashkey\n-   htx\n-   hyperliquid\n-   kucoin\n-   kucoinfutures\n-   mexc\n-   modetrade\n-   okx\n-   woo\n-   woofipro\n\nFor each exchange above, set `${EXCHANGE_ID}_API_KEY` and `${EXCHANGE_ID}_SECRET` in your `.env` file. You may configure multiple exchanges at once; the system will use the one you specify at runtime or default to the first valid configuration found.\n\n#### Logger Configuration (optional)\n\n```\nLOG_LEVEL=info # options: emerg, alert, crit, error, warning, notice, info, debug\n```\n\n#### Multi-Exchange \u0026 Multi-Strategy Support\n\n-   The system supports all CCXT certified exchanges for both public and private endpoints.\n-   At least one exchange's API Key/Secret must be configured for the system to start.\n-   You can switch the active exchange via configuration or parameters in your application code.\n-   If no valid API credentials are found for any supported exchange, the system will throw an error and log the issue.\n-   **Multiple technical indicators and strategies supported:** MACD, Bollinger Bands, KDJ, EMA, and more.\n\n## 🤝 Business Cooperation\n\nWe are actively seeking business partners and collaborators! If you are interested in exploring commercial cooperation, integration, or joint ventures with the Crypto MCP project, we would love to hear from you. Please contact us at rosendofun@gmail.com to discuss potential opportunities.\n\n## License\n\nLicensed under the Apache License, Version 2.0;\nCopyright (c) 2025 Rosendo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frosendolu%2Fcrypto-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frosendolu%2Fcrypto-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frosendolu%2Fcrypto-mcp-server/lists"}