快速对比
| 适合 | 模式 | 延迟 | 鉴权 | 从哪开始 | |
|---|---|---|---|---|---|
| REST API | 按需查询、仪表盘、用户查询 | 请求/响应 | 50–200 ms | API Key / OAuth | REST API |
| GraphQL | 分析查询、聚合、灵活 JOIN | 请求/响应 | 100–500 ms | API Key / OAuth | GraphQL |
| WebSocket | 实时 UI、浏览器 + 移动端 | 推送（订阅） | <2 ms tick | API Key | WebSocket |
| Kafka Streams | 交易引擎、索引器、告警流水线 | 流（消费） | <100 ms p99 | SASL / OAuth | Kafka |
| SDK | TS / Python / Go / Rust 的类型化访问 | 客户端库 | 匹配底层 | 继承底层 | SDK |
| CLI | 脚本、CI/CD、AI Agent、按次付费 | 命令行 | 匹配底层 | API Key / OAuth / x402 | CLI |
| MCP Server | AI Agent（Claude、Cursor、ChatGPT、自研） | Tool 协议 | 匹配底层 | API Key / x402 | MCP |
决策指南
我在做用户侧仪表盘
我在做用户侧仪表盘
用 REST 查数据与画图，加 WebSocket 做实时刷新。若屏幕需要聚合或透视数据，再叠加 GraphQL。
我在做交易 / 索引后端
我在做交易 / 索引后端
主路使用 Kafka Streams（exactly-once、水平扩展）。冷查询回退到 REST，
离线回填用 GraphQL。
我在做研究 / 临时分析
我在做研究 / 临时分析
GraphQL 提供对整个数据 cube 的维度查询，无需单链样板代码。通过 Python SDK 导出到 Notebook。
我在做浏览器 / 移动端 App
我在做浏览器 / 移动端 App
实时流（价格、交易、余额）用 WebSocket。能轮询或用户触发的操作用 REST。
我在做 AI Agent
我在做 AI Agent
MCP Server 把我们的能力目录暴露为 LLM Agent 的类型化工具。Agent 自己跑代码用 SDK；
按次付费场景用 CLI + x402/MPP。
我在做合规 / KYT 流水线
我在做合规 / KYT 流水线
大多数集成模式下直接调 REST KYT 接口即可。大吞吐筛查流水线建议订阅
Kafka transfer topic 同时旁路 REST 打分。
鉴权一览
所有接入方式共用同一组凭据——无需按通道分别签发。API Key
最快上手。一组 header 通吃 REST / GraphQL / WebSocket / CLI / SDK。
OAuth 2.0
面向生产服务间——client-credentials JWT 流程。
钱包登录 (SIWX)
Sign-In With X——让终端用户用钱包登录。
下一步
REST API
代币、钱包、交易、池子、合规的 HTTP 接口。
GraphQL
基于规整 cube 的灵活分析查询。
WebSocket
价格、交易、余额、池子事件的实时推送。
Kafka Streams
exactly-once 语义的生产级流。