快速對比
| 適合 | 模式 | 延遲 | 鑑權 | 從哪開始 | |
|---|---|---|---|---|---|
| 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 語義的生產級流。