歡迎

BCS API — 開發者文件

歡迎使用 BCS API——這份文件會帶你了解本服務的基本使用方式，包括 API key 設定、認證方式、回應格式、錯誤處理、Credit 計費規則與 API Reference 查閱方式。

你可以依照使用場景選擇不同 API 模組，例如地址標籤、風險評分、資金流向、制裁名單比對、交易行為分析、市場行為分析與多鏈資料查詢。

本文件所有範例使用的正式服務網址為 https://api.blockchainsecurity.asia，可直接使用；只要把範例中的 ak_live_YOUR_KEY 換成你自己的 API key 即可。

從哪裡開始

快速上手

五分鐘內完成第一次 API 呼叫。

認證與 API key

了解 API key 的取得、使用方式。

Credit 計費

每次成功呼叫如何計費，以及如何查餘額。

API 參考

所有端點、參數與錯誤碼。

API 模組總覽

API 依業務邏輯分為七大類，與 API Reference 的章節一一對應。由上而下也是建議的認識順序：先確認涵蓋範圍與計價，再查鏈上事實，然後在事實之上做風險判斷與調查追蹤。

分類	涵蓋內容	文件
Assets & Market Data	支援的鏈與幣種、資產識別解析、美元計價	幣種與鏈、匯率行情
On-chain Data	交易明細、對手方、歷史餘額、持倉排行與集中度	地址活動查詢、持有者與集中度
Risk & Intelligence	地址標籤身分、ML 地址分類、行為風險評分	地址標籤、地址風險、地址分類
Investigation	多跳金流展開、Bitcoin 找零偵測	智能追蹤、Bitcoin 分析
Cross-chain	跨鏈橋接續追蹤	跨鏈追蹤
Address Utilities	地址驗證、糾錯、前綴自動完成	地址工具
Events	Webhook 事件推播、即時串流	Webhook 訂閱、即時串流

服務特色

• 統一接入 — 透過一組 X-API-Key 串接多類鏈上資料、風險情資與市場行為 API。

  一致回應格式 — 所有服務共用 data、meta、error 結構，方便工程串接、系統維護與後續擴充。

  Credit 計費 — 以 credit 計價，成功回應才扣點，並回傳 credit_cost、credit_remaining 供成本控管與對帳。

  彈性限流 — 可依 API key、客戶方案與 endpoint 設定查詢頻率，支援高頻查詢與企業級用量控管。

  請求追蹤 — 每次請求皆回傳 request_id，方便除錯、稽核、客戶支援與事後對帳。

想直接試打 API？可從 API Reference 複製範例請求 /docs，或下載 OpenAPI 規格匯入 Postman、Swagger UI 等工具進行測試 /api-docs/openapi.json。