SignalStack

SignalStack

每日加密货币市场情报 — 基于真实链上数据和市场数据生成 0-100 的 Candle Review 评分。提供 REST API 和 MCP 服务，供 AI Agent 使用。

---

功能介绍

SignalStack 每天约在 06:00 UTC 从 DefiLlama、CoinGecko 和 Dune Analytics 获取实时数据，对 7 个类别的市场状况进行评分，并发布结构化的 Candle Review。

类别与权重：

类别	最高分
价格走势	25
链上数据	20
衍生品	20
ETF 资金流	15
宏观	10
市场主导地位	5
情绪	5
总计	100

评分标签：

• 80-100：强烈看涨
• 60-79：看涨
• 40-59：中性
• 20-39：看跌
• 0-19：强烈看跌

---

REST API — 实时服务

基础 URL： http://96.126.106.225:3458
OpenAPI 规范： GET /openapi.yaml

端点

端点	层级	描述
GET /health	免费	健康检查
GET /candle/today	免费 + Pro	今日 Candle Review
GET /candle/history?limit=30	免费 + Pro	历史评估
GET /candle/category/{category}	仅 Pro	类别明细
GET /openapi.yaml	免费	OpenAPI 3.0 规范

免费增值层级

	免费	Pro
API 密钥	无需	X-API-Key 请求头
/candle/today	date、score、label	完整 JSON
/candle/history	date、score、label	完整 JSON
/candle/category/:cat	❌ 403	✅ 完整明细

获取 API 密钥

联系 SignalStack 团队，或查看 RapidAPI 列表 获取 Pro 层级访问权限。免费层级无需密钥。

示例 — 免费层级

curl http://96.126.106.225:3458/candle/today

{
  "date": "2026-03-28",
  "score": 67,
  "label": "Bullish"
}

示例 — Pro 层级

curl -H "X-API-Key: your-key-here" http://96.126.106.225:3458/candle/today

{
  "date": "2026-03-28",
  "score": 67,
  "label": "Bullish",
  "categories": {
    "price_action": { "score": 18, "max": 25, "summary": "BTC up 3.2% on strong volume." },
    "on_chain":     { "score": 14, "max": 20, "summary": "Exchange reserves declining." },
    "derivatives":  { "score": 13, "max": 20, "summary": "Funding rates slightly positive." },
    "etf_flows":    { "score": 11, "max": 15, "summary": "Spot ETF net inflows $400M." },
    "macro":        { "score": 6,  "max": 10, "summary": "DXY weakening, risk-on." },
    "dominance":    { "score": 3,  "max": 5,  "summary": "BTC dominance stable at 54%." },
    "sentiment":    { "score": 2,  "max": 5,  "summary": "Fear & Greed index at 68." }
  },
  "outlook": "Near-term momentum remains bullish.",
  "what_happened": "Spot ETF inflows hit $400M. BTC held above $70k.",
  "generated_at": "2026-03-28T06:00:01.000Z"
}

---

MCP 服务 — AI Agent 集成

SignalStack 通过 SSE 传输协议提供 MCP（Model Context Protocol）服务，便于直接集成 AI Agent。

连接

SSE endpoint:     GET  http://96.126.106.225:3458/mcp
Request endpoint: POST http://96.126.106.225:3458/mcp

可用的 MCP 工具

工具	层级	描述
candle.get_today	免费 + Pro	今日综合评分
candle.get_history	免费 + Pro	历史评估
candle.get_category	Pro	类别明细

通过 MCP 客户端连接

// Example using MCP SDK
const client = new Client({ name: "my-agent", version: "1.0.0" }, { capabilities: {} });
const transport = new SSEClientTransport(new URL("http://96.126.106.225:3458/mcp"));
await client.connect(transport);

const result = await client.callTool({ name: "candle.get_today", arguments: {} });

要访问 Pro 层级，请在 SSE 连接中将 X-API-Key 作为请求头传入。

---

OpenAPI 规范

完整的 OpenAPI 3.0 规范可通过以下地址实时获取：

GET http://96.126.106.225:3458/openapi.yaml

也可在项目根目录的静态文件 openapi.yaml 中获取。

---

技术栈

• 运行时： Node.js + TypeScript
• 框架： Express
• 数据源： DefiLlama（免费）、CoinGecko（免费/演示版）、Dune Analytics
• 存储： SQLite（评分存储、api-keys.db）
• 传输： REST + MCP SSE
• 部署： systemd 服务 + nginx 反向代理

---

收录目录

SignalStack 已收录于：

• RapidAPI — REST API 发现平台
• Smithery — MCP 服务注册目录
• mcp.run — MCP 服务注册目录
• Futurepedia — AI 工具目录
• There's An AI For That — AI 工具目录

---

版本

阶段	状态	描述
P0-P2	✅ 已完成	MCP 工具：DefiLlama + CoinGecko + Dune（21 个工具）
P3	✅ 已完成	Candle Review 评分引擎
P4	✅ 已完成	REST API + 公共 MCP SSE + 免费增值访问控制
P5	✅ 已完成	OpenAPI 规范 + 目录收录
P6	待办	Stripe 计费集成