帳戶與認證
如何取得 Access Token?
如何取得 Access Token?
- 登入 ChainStream Dashboard
- 進入 Apps 頁面
- 點擊 Create New App
- 取得 Client ID 和 Client Secret
- 使用 Client ID 和 Client Secret 向 Auth 服務請求 Access Token (JWT)
資料相關
支援哪些區塊鏈?
支援哪些區塊鏈?
目前支援以下公鏈:
完整列表見 即時資料概念。
| 鏈 | 狀態 | 說明 |
|---|---|---|
| Ethereum | ✅ 已支援 | 包括主網和主要 L2 |
| Solana | ✅ 已支援 | |
| BSC | ✅ 已支援 | |
| Polygon | ✅ 已支援 | |
| Arbitrum | ✅ 已支援 | |
| Optimism | ✅ 已支援 | |
| Base | ✅ 已支援 | |
| Tron | ✅ 已支援 |
資料延遲是多少?
資料延遲是多少?
| 資料類型 | 延遲 |
|---|---|
| 即時價格(WebSocket) | < 2ms (P99) |
| REST API 查詢 | < 100ms |
| 歷史資料查詢 | < 500ms |
資料更新頻率是多少?
資料更新頻率是多少?
| 資料類型 | 更新頻率 |
|---|---|
| 代幣價格 | 即時(每筆交易觸發) |
| 錢包持倉 | 每個區塊更新 |
| Smart Money 標籤 | 每日更新 |
計費相關
免費方案有什麼限制?
免費方案有什麼限制?
Free 方案限制:
- 額度: 每月 30K Units
- 請求頻率: 10 請求/秒
- 資料延遲: 可能有 1-2 秒延遲
- SLA: 不保證
- 超額: 額度用盡後返回 403 錯誤,下月重置
如何查看目前使用量?
如何查看目前使用量?
- 登入 Dashboard
- 在 Usage 頁面查看當月使用量、剩餘額度、歷史趨勢
支援哪些付款方式?
支援哪些付款方式?
| 方式 | 支援的方案 |
|---|---|
| 信用卡(Visa, MasterCard, AMEX) | 所有方案 |
| 加密貨幣(USDT, USDC) | Starter 及以上 |
| 銀行轉帳 | Enterprise / Custom |
可以隨時升級或降級方案嗎?
可以隨時升級或降級方案嗎?
- 升級: 立即生效,按比例補差價
- 降級: 在下個帳單週期生效
未使用的額度可以累積嗎?
未使用的額度可以累積嗎?
不可以。每月額度在月底清零,不累積到下月。建議根據實際用量選擇合適的方案。
技術問題
收到 429 或 403 錯誤怎麼辦?
收到 429 或 403 錯誤怎麼辦?
- 429 錯誤:請求頻率超限
- 403 錯誤:配額用盡
-
429 - 檢查是否超頻
- Free 方案:10 請求/分鐘
- 付費方案:見 API 安全
-
403 - 檢查額度是否用盡
- 在 Dashboard → Usage 查看剩餘額度
- 付費方案可購買額外用量恢復服務
- 429:實現請求節流或指數退避重試
- 403:購買額外用量或升級方案
- 使用 WebSocket 替代輪詢減少請求數
如何處理 WebSocket 斷連?
如何處理 WebSocket 斷連?
建議實現自動重連機制:重連建議:
- 使用指數退避策略(1s → 2s → 4s → … → 30s)
- 設定最大重連延遲(如 30 秒)
- 重連成功後重新訂閱資料
API 回應格式是什麼?
API 回應格式是什麼?
如何除錯 API 請求?
如何除錯 API 請求?
KYT/KYA 相關
KYT 和 KYA 有什麼區別?
KYT 和 KYA 有什麼區別?
| 功能 | KYA (Address Verification) | KYT Report |
|---|---|---|
| 用途 | 驗證地址風險和畫像分析 | 交易級別的風險報告 |
| 輸入 | 錢包地址 | 交易雜湊或地址 |
| 輸出 | 風險等級 + 地址類型 + 風險暴露詳情 | 交易相關的風險分析 |
| 典型場景 | 使用者註冊/充值前的地址審查 | 特定交易的合規檢查 |
Address Verification 返回哪些資訊?
Address Verification 返回哪些資訊?
地址驗證返回以下欄位:
| 欄位 | 說明 | 示例值 |
|---|---|---|
| Risk | 風險等級 | Low, Medium, High, Severe |
| Status | 驗證狀態 | COMPLETE, PENDING |
| Address Type | 地址類型 | PRIVATE_WALLET, EXCHANGE, CONTRACT 等 |
| Risk Exposures | 風險暴露詳情 | 各類風險標籤及關聯金額 |
風險等級如何解讀?
風險等級如何解讀?
Address Verification 返回以下風險等級:
注意: 具體處理策略應根據你的業務合規要求設定,以上僅為參考建議。
| 風險等級 | 含義 | 建議操作 |
|---|---|---|
| Low | 低風險,未發現明顯可疑關聯 | 可正常處理 |
| Medium | 中等風險,存在一定可疑關聯 | 建議人工複核 |
| High | 高風險,存在較多可疑關聯 | 建議拒絕或加強審查 |
| Severe | 嚴重風險,直接關聯制裁/非法實體 | 強烈建議拒絕 |
Risk Exposures 中的風險標籤有哪些?
Risk Exposures 中的風險標籤有哪些?
Risk Exposures 顯示地址與各類風險實體的關聯情況,常見標籤包括:高危標籤(Severe):
中性/低危標籤:
其他風險標籤:
每個標籤會顯示:
| 標籤 | 說明 |
|---|---|
| sanctioned entity | 與受制裁實體有關聯 |
| sanctioned jurisdiction | 與受制裁司法管轄區有關聯 |
| terrorist financing | 與恐怖融資有關聯 |
| 標籤 | 說明 |
|---|---|
| bridge | 透過跨鏈橋轉移資金 |
| decentralized exchange | 透過 DEX 交易 |
| atm | 透過加密貨幣 ATM 交易 |
| 標籤 | 說明 |
|---|---|
| mixer | 透過混幣器 |
| gambling | 與賭博平台有關聯 |
| darknet | 與暗網市場有關聯 |
- direct / indirect:直接關聯或間接關聯
- 金額:關聯的資金量
- 百分比:佔該地址總交易量的比例
direct 和 indirect 有什麼區別?
direct 和 indirect 有什麼區別?
| 類型 | 含義 | 風險程度 |
|---|---|---|
| direct | 地址直接與風險實體交互 | 較高 |
| indirect | 地址透過中間地址間接關聯風險實體 | 相對較低 |
sanctioned entity + direct:該地址直接向受制裁地址轉帳sanctioned entity + indirect:該地址的關聯地址曾與受制裁地址交互
Address Type 有哪些類型?
Address Type 有哪些類型?
| 地址類型 | 說明 |
|---|---|
| PRIVATE_WALLET | 個人錢包地址 |
| EXCHANGE | 中心化交易所地址 |
| CONTRACT | 智能合約地址 |
| MINING_POOL | 礦池地址 |
| MERCHANT | 商戶地址 |
| PAYMENT_PROCESSOR | 支付處理商 |
如何透過 API 呼叫 Address Verification?
如何透過 API 呼叫 Address Verification?
KYT 檢測需要多長時間?
KYT 檢測需要多長時間?
| 操作 | 回應時間 |
|---|---|
| 新地址首次驗證 | 通常 1-5 秒 |
| 已快取地址查詢 | < 500ms |
| 複雜地址(大量交易) | 可能需要 5-10 秒 |
PENDING 時表示正在分析中,可稍後重試獲取完整結果。KYT/KYA 如何計費?
KYT/KYA 如何計費?
KYT/KYA API 不消耗方案 Units,而是從獨立的 KYT 帳戶餘額扣費(美元計價)。
請在 Dashboard → KYT Service 頁面進行充值。
| 操作 | 費用 |
|---|---|
| 充值風險評估 | $0.25/次 |
| 提現風險評估 | $0.25/次 |
| 註冊地址 | $1.25/次 |
AI/MCP 相關
什麼是 MCP?
什麼是 MCP?
MCP(Model Context Protocol)是 Anthropic 提出的協議,讓 AI 模型能夠呼叫外部工具。ChainStream 提供 MCP Server,讓 Claude 等 AI 可以直接查詢鏈上資料。詳見 MCP Server 文件。
如何在 Claude Desktop 中使用 ChainStream?
如何在 Claude Desktop 中使用 ChainStream?
- 安裝 ChainStream MCP Server
- 設定 Claude Desktop 的 MCP 設定
- 重新啟動 Claude Desktop
- 開始對話,Claude 可以自動呼叫 ChainStream 查詢資料
AI 可以執行交易嗎?
AI 可以執行交易嗎?
目前不支援。 ChainStream MCP Server 僅提供讀取操作,包括:
- 查詢代幣價格和資訊
- 查詢錢包持倉和交易記錄
- 執行 KYT/KYA 風險評估
MCP 呼叫如何計費?
MCP 呼叫如何計費?
MCP 呼叫與直接 API 呼叫計費相同,按照實際呼叫的 API 類型消耗對應的 Units。
聯繫支援
如何獲取技術支援?
如何獲取技術支援?
| 管道 | 適用場景 | 回應時間 |
|---|---|---|
| 信箱 support@chainstream.io | 一般問題 | 24 小時內 |
| Discord 社群 | 技術討論、使用問題 | 社群互助 |
| 專屬客戶經理 | Enterprise / Custom 客戶 | 4 小時內 |
- Client ID
- 錯誤資訊和重現步驟
文件有錯誤如何回饋?
文件有錯誤如何回饋?
- GitHub Issues: 提交文件問題
- 信件: docs@chainstream.io
沒找到答案?
聯繫我們
如果以上 FAQ 沒有解答你的問題,請聯繫技術支援團隊。

