io.github.lazymac2x/crypto-signal

Cloudflare Workers MCP server: crypto-signal

Open source Repository Open in the app JSON README (API)

About

Cloudflare Workers MCP server: crypto-signal

Details

Kind: MCP servers
Topic: Finance & crypto
Publisher: lazymac2x
Origin: official
Category: ferramentas
Transport: http
Version: 1.0.0
Last push: 2026-04-11T00:57:44Z
Repository state: ativo
Language: JavaScript
Added: 2026-08-29 04:00:23
Updated: 2026-08-29 04:00:23
Origin id: io.github.lazymac2x/crypto-signal

README

<p align="center"><img src="logo.png" width="120" alt="logo"></p>

[![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)

# crypto-signal-api

> ⭐ **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).

[![npm](https://img.shields.io/npm/v/@lazymac/mcp.svg?label=%40lazymac%2Fmcp&color=orange)](https://www.npmjs.com/package/@lazymac/mcp)
[![Smithery](https://img.shields.io/badge/Smithery-lazymac%2Fmcp-orange)](https://smithery.ai/server/lazymac/mcp)
[![lazymac Pro](https://img.shields.io/badge/lazymac%20Pro-%2429%2Fmo-ff6b35)](https://coindany.gumroad.com/l/zlewvz)
[![api.lazy-mac.com](https://img.shields.io/badge/REST-api.lazy--mac.com-orange)](https://api.lazy-mac.com)

> 🚀 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.

Real-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.

**No API key required** — uses Binance public market data.

## Quick Start

```bash
npm install
npm start        # REST API on http://localhost:3100
npm run mcp      # MCP server (stdio, for AI agents)
```

## REST API Endpoints

### `GET /api/v1/signal/:symbol`
Combined trading signal with full indicator breakdown.

```bash
curl http://localhost:3100/api/v1/signal/BTCUSDT
curl http://localhost:3100/api/v1/signal/ETHUSDT?interval=4h
```

**Response:**
```json
{
  "symbol": "BTCUSDT",
  "interval": "1h",
  "signal": {
    "action": "BUY",
    "strength": "moderate",
    "confidence": 58,
    "score": 4,
    "details": [...]
  },
  "indicators": {
    "price": 87250.50,
    "rsi": 35.2,
    "macd": { "MACD": -120.5, "signal": -95.3, "histogram": -25.2 },
    "ema": { "ema9": 87100, "ema21": 87400, "ema50": 88200 },
    "bollingerBands": { "upper": 89500, "middle": 87800, "lower": 86100 },
    "stochRsi": { "k": 15.3, "d": 18.7 },
    "atr": 850.5,
    "volume": { "current": 1250.5, "average": 980.3, "ratio": 1.28 }
  }
}
```

### `GET /api/v1/indicators/:symbol`
Technical indicators only (no signal).

### `GET /api/v1/candles/:symbol`
Raw OHLCV candle data.

| Param | Default | Description |
|-------|---------|-------------|
| `interval` | `1h` | `1m, 5m, 15m, 1h, 4h, 1d` |
| `limit` | `100` | Max 500 |

### `GET /api/v1/screener`
Scan top coins by volume with signals for each.

```bash
curl http://localhost:3100/api/v1/screener?limit=10&interval=4h
```

## MCP Server (for AI Agents)

Run as an MCP tool server over stdio:

```bash
node src/mcp-server.js
```

### Available Tools

| Tool | Description |
|------|-------------|
| `get_crypto_signal` | Trading signal + indicators for a pair |
| `get_crypto_indicators` | Detailed technical indicators |
| `screen_crypto_market` | Scan top coins with signals |

### Claude Desktop Config

```json
{
  "mcpServers": {
    "crypto-signals": {
      "command": "node",
      "args": ["/path/to/crypto-signal-api/src/mcp-server.js"]
    }
  }
}
```

## Signal Logic

| Score | Action | Strength |
|-------|--------|----------|
| ≥ +4 | STRONG_BUY | strong |
| +2 to +3 | BUY | moderate |
| -1 to +1 | HOLD | weak |
| -2 to -3 | SELL | moderate |
| ≤ -4 | STRONG_SELL | strong |

Indicators scored: RSI, MACD histogram, EMA alignment, Bollinger Band position, Stochastic RSI, Volume ratio.

## License

MIT

## Related projects

- 🧰 **[lazymac-mcp](https://github.com/lazymac2x/lazymac-mcp)** — Single MCP server exposing 15+ lazymac APIs as tools for Claude Code, Cursor, Windsurf
- ✅ **[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
- 🌐 **[api.lazy-mac.com](https://api.lazy-mac.com)** — 36+ developer APIs, REST + MCP, free tier

<sub>💡 Host your own stack? <a href="https://m.do.co/c/c8c07a9d3273">Get $200 DigitalOcean credit</a> via lazymac referral link.</sub>

io.github.lazymac2x/crypto-signal

About

Details

README

More