跳轉到主要內容

帳戶與認證

  1. 登入 ChainStream Dashboard
  2. 進入 Apps 頁面
  3. 點擊 Create New App
  4. 取得 Client ID 和 Client Secret
  5. 使用 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 標籤每日更新
使用 WebSocket 可獲得最即時的資料推送。

計費相關

Free 方案限制:
  • 額度: 每月 30K Units
  • 請求頻率: 10 請求/秒
  • 資料延遲: 可能有 1-2 秒延遲
  • SLA: 不保證
  • 超額: 額度用盡後返回 403 錯誤,下月重置
適合開發測試和功能驗證,不建議用於生產環境。
  1. 登入 Dashboard
  2. Usage 頁面查看當月使用量、剩餘額度、歷史趨勢
方式支援的方案
信用卡(Visa, MasterCard, AMEX)所有方案
加密貨幣(USDT, USDC)Starter 及以上
銀行轉帳Enterprise / Custom
加密貨幣支付支援 ERC-20 和 TRC-20 網路。
  • 升級: 立即生效,按比例補差價
  • 降級: 在下個帳單週期生效
在 Dashboard → Billing → Subscription 頁面操作。
不可以。每月額度在月底清零,不累積到下月。建議根據實際用量選擇合適的方案。

技術問題

  • 429 錯誤:請求頻率超限
  • 403 錯誤:配額用盡
排查步驟:
  1. 429 - 檢查是否超頻
    • Free 方案:10 請求/分鐘
    • 付費方案:見 API 安全
  2. 403 - 檢查額度是否用盡
    • 在 Dashboard → Usage 查看剩餘額度
    • 付費方案可購買額外用量恢復服務
解決方案:
  • 429:實現請求節流或指數退避重試
  • 403:購買額外用量或升級方案
  • 使用 WebSocket 替代輪詢減少請求數
// 錯誤處理示例
async function handleApiError(error) {
  if (error.status === 429) {
    // 請求頻率超限,等待後重試
    await sleep(1000);
    return retry();
  } else if (error.status === 403) {
    // 配額用盡,需要購買額外用量
    console.error('配額用盡,請在 Dashboard 購買額外用量');
  }
}
建議實現自動重連機制:
class ChainStreamWebSocket {
  constructor(baseUrl, accessToken) {
    this.baseUrl = baseUrl;
    this.accessToken = accessToken;
    this.reconnectDelay = 1000;
    this.maxReconnectDelay = 30000;
    this.connect();
  }

  connect() {
    // 透過 URL 參數傳遞 token
    const url = `${this.baseUrl}?token=${this.accessToken}`;
    this.ws = new WebSocket(url);
    this.ws.onopen = () => {
      console.log('Connected');
      this.reconnectDelay = 1000; // 重置延遲
    };
    this.ws.onclose = () => {
      console.log('Disconnected, reconnecting...');
      setTimeout(() => this.connect(), this.reconnectDelay);
      // 指數退避
      this.reconnectDelay = Math.min(
        this.reconnectDelay * 2,
        this.maxReconnectDelay
      );
    };
    this.ws.onerror = (error) => {
      console.error('WebSocket error:', error);
    };
  }
}
重連建議:
  • 使用指數退避策略(1s → 2s → 4s → … → 30s)
  • 設定最大重連延遲(如 30 秒)
  • 重連成功後重新訂閱資料
所有 API 返回 JSON 格式。成功回應:
{
  "chain": "solana",
  "address": "So11111111111111111111111111111111111111112",
  "name": "Wrapped SOL",
  "symbol": "SOL",
  "decimals": 9,
  "price": 95.42
}
錯誤回應:
{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Token not found"
  }
}
常見錯誤碼見 Error Codes
方法 1:使用 API PlaygroundAPI Reference 頁面使用 “Try It” 功能,無需撰寫程式碼即可測試。方法 2:使用 cURL新增 -v 參數查看詳細請求資訊:
curl -v "https://api.chainstream.io/v1/token/{chain}/{address}/metadata" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

KYT/KYA 相關

功能KYA (Address Verification)KYT Report
用途驗證地址風險和畫像分析交易級別的風險報告
輸入錢包地址交易雜湊或地址
輸出風險等級 + 地址類型 + 風險暴露詳情交易相關的風險分析
典型場景使用者註冊/充值前的地址審查特定交易的合規檢查
詳見 Security Compliance 文件
地址驗證返回以下欄位:
欄位說明示例值
Risk風險等級Low, Medium, High, Severe
Status驗證狀態COMPLETE, PENDING
Address Type地址類型PRIVATE_WALLET, EXCHANGE, CONTRACT 等
Risk Exposures風險暴露詳情各類風險標籤及關聯金額
Address Verification 返回以下風險等級:
風險等級含義建議操作
Low低風險,未發現明顯可疑關聯可正常處理
Medium中等風險,存在一定可疑關聯建議人工複核
High高風險,存在較多可疑關聯建議拒絕或加強審查
Severe嚴重風險,直接關聯制裁/非法實體強烈建議拒絕
注意: 具體處理策略應根據你的業務合規要求設定,以上僅為參考建議。
Risk Exposures 顯示地址與各類風險實體的關聯情況,常見標籤包括:高危標籤(Severe):
標籤說明
sanctioned entity與受制裁實體有關聯
sanctioned jurisdiction與受制裁司法管轄區有關聯
terrorist financing與恐怖融資有關聯
中性/低危標籤:
標籤說明
bridge透過跨鏈橋轉移資金
decentralized exchange透過 DEX 交易
atm透過加密貨幣 ATM 交易
其他風險標籤:
標籤說明
mixer透過混幣器
gambling與賭博平台有關聯
darknet與暗網市場有關聯
每個標籤會顯示:
  • direct / indirect:直接關聯或間接關聯
  • 金額:關聯的資金量
  • 百分比:佔該地址總交易量的比例
類型含義風險程度
direct地址直接與風險實體交互較高
indirect地址透過中間地址間接關聯風險實體相對較低
示例:
  • sanctioned entity + direct:該地址直接向受制裁地址轉帳
  • sanctioned entity + indirect:該地址的關聯地址曾與受制裁地址交互
即使是 indirect 關聯,如果涉及 Severe 級別的標籤(如制裁、恐怖融資),仍建議謹慎處理。
地址類型說明
PRIVATE_WALLET個人錢包地址
EXCHANGE中心化交易所地址
CONTRACT智能合約地址
MINING_POOL礦池地址
MERCHANT商戶地址
PAYMENT_PROCESSOR支付處理商
地址類型有助於理解資金流向和業務背景。
curl -X POST "https://api.chainstream.io/v1/kya/address/verify" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "So11111111111111111111111111111111111111112",
    "chain": "sol"
  }'
回應示例:
{
  "address": "So11111111111111111111111111111111111111112",
  "risk": "Low",
  "status": "COMPLETE",
  "address_type": "PRIVATE_WALLET",
  "risk_exposures": [
    {
      "label": "sanctioned entity",
      "severity": "Severe",
      "type": "indirect",
      "amount": 372262.76,
      "percentage": 0.6
    },
    {
      "label": "bridge",
      "severity": "Info",
      "type": "indirect",
      "amount": 816082.22,
      "percentage": 1.3
    }
  ]
}
操作回應時間
新地址首次驗證通常 1-5 秒
已快取地址查詢< 500ms
複雜地址(大量交易)可能需要 5-10 秒
狀態為 PENDING 時表示正在分析中,可稍後重試獲取完整結果。
KYT/KYA API 不消耗方案 Units,而是從獨立的 KYT 帳戶餘額扣費(美元計價)。
操作費用
充值風險評估$0.25/次
提現風險評估$0.25/次
註冊地址$1.25/次
請在 Dashboard → KYT Service 頁面進行充值。

AI/MCP 相關

MCP(Model Context Protocol)是 Anthropic 提出的協議,讓 AI 模型能夠呼叫外部工具。ChainStream 提供 MCP Server,讓 Claude 等 AI 可以直接查詢鏈上資料。詳見 MCP Server 文件
  1. 安裝 ChainStream MCP Server
  2. 設定 Claude Desktop 的 MCP 設定
  3. 重新啟動 Claude Desktop
  4. 開始對話,Claude 可以自動呼叫 ChainStream 查詢資料
詳細設定步驟見 Claude Integration 指南
目前不支援。 ChainStream MCP Server 僅提供讀取操作,包括:
  • 查詢代幣價格和資訊
  • 查詢錢包持倉和交易記錄
  • 執行 KYT/KYA 風險評估
不支援自動執行交易、轉帳等寫入操作,這是出於安全考量。
MCP 呼叫與直接 API 呼叫計費相同,按照實際呼叫的 API 類型消耗對應的 Units。

聯繫支援

管道適用場景回應時間
信箱 support@chainstream.io一般問題24 小時內
Discord 社群技術討論、使用問題社群互助
專屬客戶經理Enterprise / Custom 客戶4 小時內
聯繫時請提供:
  • Client ID
  • 錯誤資訊和重現步驟
感謝幫助我們改進文件!

沒找到答案?

聯繫我們

如果以上 FAQ 沒有解答你的問題,請聯繫技術支援團隊。