{
  "markdown": "<p align=\"center\"><img src=\"logo.png\" width=\"120\" alt=\"logo\"></p>\n\n[![lazymac API Store](https://img.shields.io/badge/lazymac-API%20Store-blue?style=flat-square)](https://lazymac2x.github.io/lazymac-api-store/) [![Gumroad](https://img.shields.io/badge/Buy%20on-Gumroad-ff69b4?style=flat-square)](https://coindany.gumroad.com/) [![MCPize](https://img.shields.io/badge/MCP-MCPize-green?style=flat-square)](https://mcpize.com/mcp/crypto-signal-api)\n\n# crypto-signal-api\n\n> ⭐ **Building in public from $0 MRR.** Star if you want to follow the journey — [lazymac-mcp](https://github.com/lazymac2x/lazymac-mcp) (42 tools, one MCP install) · [lazymac-k-mcp](https://github.com/lazymac2x/lazymac-k-mcp) (Korean wedge) · [lazymac-sdk](https://github.com/lazymac2x/lazymac-sdk) (TS client) · [api.lazy-mac.com](https://api.lazy-mac.com) · [Pro $29/mo](https://coindany.gumroad.com/l/zlewvz).\n\n[![npm](https://img.shields.io/npm/v/@lazymac/mcp.svg?label=%40lazymac%2Fmcp&color=orange)](https://www.npmjs.com/package/@lazymac/mcp)\n[![Smithery](https://img.shields.io/badge/Smithery-lazymac%2Fmcp-orange)](https://smithery.ai/server/lazymac/mcp)\n[![lazymac Pro](https://img.shields.io/badge/lazymac%20Pro-%2429%2Fmo-ff6b35)](https://coindany.gumroad.com/l/zlewvz)\n[![api.lazy-mac.com](https://img.shields.io/badge/REST-api.lazy--mac.com-orange)](https://api.lazy-mac.com)\n\n> 🚀 Want all 42 lazymac tools through ONE MCP install? `npx -y @lazymac/mcp` · [Pro $29/mo](https://coindany.gumroad.com/l/zlewvz) for unlimited calls.\n\nReal-time cryptocurrency trading signals powered by technical analysis. Fetches live data from Binance and computes RSI, MACD, EMA, Bollinger Bands, Stochastic RSI, ATR, and volume analysis to generate actionable BUY/SELL/HOLD signals.\n\n**No API key required** — uses Binance public market data.\n\n## Quick Start\n\n```bash\nnpm install\nnpm start        # REST API on http://localhost:3100\nnpm run mcp      # MCP server (stdio, for AI agents)\n```\n\n## REST API Endpoints\n\n### `GET /api/v1/signal/:symbol`\nCombined trading signal with full indicator breakdown.\n\n```bash\ncurl http://localhost:3100/api/v1/signal/BTCUSDT\ncurl http://localhost:3100/api/v1/signal/ETHUSDT?interval=4h\n```\n\n**Response:**\n```json\n{\n  \"symbol\": \"BTCUSDT\",\n  \"interval\": \"1h\",\n  \"signal\": {\n    \"action\": \"BUY\",\n    \"strength\": \"moderate\",\n    \"confidence\": 58,\n    \"score\": 4,\n    \"details\": [...]\n  },\n  \"indicators\": {\n    \"price\": 87250.50,\n    \"rsi\": 35.2,\n    \"macd\": { \"MACD\": -120.5, \"signal\": -95.3, \"histogram\": -25.2 },\n    \"ema\": { \"ema9\": 87100, \"ema21\": 87400, \"ema50\": 88200 },\n    \"bollingerBands\": { \"upper\": 89500, \"middle\": 87800, \"lower\": 86100 },\n    \"stochRsi\": { \"k\": 15.3, \"d\": 18.7 },\n    \"atr\": 850.5,\n    \"volume\": { \"current\": 1250.5, \"average\": 980.3, \"ratio\": 1.28 }\n  }\n}\n```\n\n### `GET /api/v1/indicators/:symbol`\nTechnical indicators only (no signal).\n\n### `GET /api/v1/candles/:symbol`\nRaw OHLCV candle data.\n\n| Param | Default | Description |\n|-------|---------|-------------|\n| `interval` | `1h` | `1m, 5m, 15m, 1h, 4h, 1d` |\n| `limit` | `100` | Max 500 |\n\n### `GET /api/v1/screener`\nScan top coins by volume with signals for each.\n\n```bash\ncurl http://localhost:3100/api/v1/screener?limit=10&interval=4h\n```\n\n## MCP Server (for AI Agents)\n\nRun as an MCP tool server over stdio:\n\n```bash\nnode src/mcp-server.js\n```\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_crypto_signal` | Trading signal + indicators for a pair |\n| `get_crypto_indicators` | Detailed technical indicators |\n| `screen_crypto_market` | Scan top coins with signals |\n\n### Claude Desktop Config\n\n```json\n{\n  \"mcpServers\": {\n    \"crypto-signals\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/crypto-signal-api/src/mcp-server.js\"]\n    }\n  }\n}\n```\n\n## Signal Logic\n\n| Score | Action | Strength |\n|-------|--------|----------|\n| ≥ +4 | STRONG_BUY | strong |\n| +2 to +3 | BUY | moderate |\n| -1 to +1 | HOLD | weak |\n| -2 to -3 | SELL | moderate |\n| ≤ -4 | STRONG_SELL | strong |\n\nIndicators scored: RSI, MACD histogram, EMA alignment, Bollinger Band position, Stochastic RSI, Volume ratio.\n\n## License\n\nMIT\n\n## Related projects\n\n- 🧰 **[lazymac-mcp](https://github.com/lazymac2x/lazymac-mcp)** — Single MCP server exposing 15+ lazymac APIs as tools for Claude Code, Cursor, Windsurf\n- ✅ **[lazymac-api-healthcheck-action](https://github.com/lazymac2x/lazymac-api-healthcheck-action)** — Free GitHub Action to ping any URL on a cron and fail on non-2xx\n- 🌐 **[api.lazy-mac.com](https://api.lazy-mac.com)** — 36+ developer APIs, REST + MCP, free tier\n\n<sub>💡 Host your own stack? <a href=\"https://m.do.co/c/c8c07a9d3273\">Get $200 DigitalOcean credit</a> via lazymac referral link.</sub>\n",
  "bytes": 4704,
  "sha": "c9bfd1172d334286f324df1593643452db1bec45976bf357abee9b06f9242556",
  "repo_slug": "lazymac2x/crypto-signal-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lazymac2x_crypto_signal_b9c57322/readme"
}