Toobit MCP Service

本项目封装了 Toobit 现货 API 的核心行情接口，提供统一的 MCP（Multi-Channel Platform）服务接口。

主要功能

- 封装 Toobit 现货行情 API 主要接口 - 统一 RESTful API 服务，所有接口返回格式标准化 - 易于扩展和二次开发

目录结构

toobit-mcp-service/
├── src/
│   ├── api/           # Toobit API 封装
│   ├── controllers/   # MCP 业务接口
│   ├── utils/         # 工具函数，如签名、请求封装
│   └── index.ts       # 入口
├── test/              # 单元测试
├── package.json
├── README.md
└── .env               # API KEY 等敏感信息

快速开始

1. 安装依赖：

   npm install
   

2. 配置 .env 文件，填写 Toobit API KEY/SECRET：

   TOOBIT_API_KEY=你的APIKEY
   TOOBIT_API_SECRET=你的APISECRET
   

3. 启动服务：

   npm run dev
   

MCP 支持的接口

1. 交易所信息

- GET /mcp/spot/exchangeInfo - 获取交易所支持的币对、精度等基础信息 - 示例：

    GET http://localhost:3000/mcp/spot/exchangeInfo
    

2. 深度（Order Book）

- GET /mcp/spot/quote/depth - 获取指定交易对的订单簿深度 - 示例：

    GET http://localhost:3000/mcp/spot/quote/depth?symbol=BTCUSDT&limit=20
    

3. 最新成交

- GET /mcp/spot/quote/trades - 获取指定交易对的最新成交记录 - 示例：

    GET http://localhost:3000/mcp/spot/quote/trades?symbol=BTCUSDT&limit=10
    

4. K线数据

- GET /mcp/spot/quote/klines - 获取指定交易对的K线/蜡烛图数据 - 示例：

    GET http://localhost:3000/mcp/spot/quote/klines?symbol=BTCUSDT&interval=1h&limit=10
    

5. 24小时行情

- GET /mcp/spot/quote/ticker/24hr - 获取24小时价格变动统计 - 示例：

    GET http://localhost:3000/mcp/spot/quote/ticker/24hr?symbol=BTCUSDT
    

6. 最新价格

- GET /mcp/spot/quote/ticker/price - 获取指定交易对的最新价格 - 示例：

    GET http://localhost:3000/mcp/spot/quote/ticker/price?symbol=BTCUSDT
    

7. 最优挂单

- GET /mcp/spot/quote/ticker/bookTicker - 获取指定交易对的最优买一/卖一挂单 - 示例：

    GET http://localhost:3000/mcp/spot/quote/ticker/bookTicker?symbol=BTCUSDT
    

8. 合并深度

- GET /mcp/spot/quote/depth/merged - 获取指定交易对的合并订单簿深度 - 示例：

    GET http://localhost:3000/mcp/spot/quote/depth/merged?symbol=BTCUSDT&limit=20
    

SSE（Server-Sent Events）实时行情接口

所有行情接口均支持SSE实时推送，路径为原有RESTful接口后加 /stream，如：

- /mcp/spot/quote/ticker/price/stream
- /mcp/spot/quote/trades/stream
- /mcp/spot/quote/klines/stream
- /mcp/spot/quote/depth/stream
- /mcp/spot/quote/ticker/24hr/stream
- /mcp/spot/quote/ticker/bookTicker/stream
- /mcp/spot/quote/depth/merged/stream
- /mcp/spot/exchangeInfo/stream（演示用）

SSE接口特点

- 每2秒推送一次最新数据，格式同RESTful接口。 - 前端可用EventSource直接接收推送。 - 适合实时行情、K线、深度、成交等场景。

前端SSE接收示例（JavaScript）

const es = new EventSource('http://localhost:3000/mcp/spot/quote/ticker/price/stream?symbol=BTCUSDT');
es.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.code === 0) {
    console.log('最新价格:', msg.data);
  } else {
    console.error('SSE错误:', msg.msg);
  }
};
es.onerror = (err) => {
  console.error('SSE连接异常', err);
};

注意事项

- SSE为单向推送，适合行情类高频更新。 - 如需停止接收，调用es.close()。 - 可根据业务调整推送频率和数据内容。

返回格式

- 所有接口返回：

  {
    "code": 0,
    "msg": "success",
    "data": { ... } // 对应Toobit原始数据
  }
  

错误时：

  {
    "code": -1,
    "msg": "错误信息",
    "data": null
  }
  

参考文档

- Toobit API 官方文档 - 新版行情接口示例

---

如需扩展更多接口，请在 src/api/ 和 src/controllers/ 目录下新增对应文件。