> For the complete documentation index, see [llms.txt](https://docs.blockchainsecurity.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockchainsecurity.asia/documentation/readme.md).

# 歡迎

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

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

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

## 從哪裡開始

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-rocket-launch">:rocket-launch:</i></h4></td><td><strong>快速上手</strong></td><td>五分鐘內完成第一次 API 呼叫。</td><td><a href="/pages/fMIKfNrelo451cfsRJe8">/pages/fMIKfNrelo451cfsRJe8</a></td></tr><tr><td><h4><i class="fa-key">:key:</i></h4></td><td><strong>認證與 API key</strong></td><td>了解 API key 的取得、使用方式。</td><td><a href="/pages/MFQ1oeKPnts4wocXInGo">/pages/MFQ1oeKPnts4wocXInGo</a></td></tr><tr><td><h4><i class="fa-coins">:coins:</i></h4></td><td><strong>Credit 計費</strong></td><td>每次成功呼叫如何計費，以及如何查餘額。</td><td><a href="/pages/pdZr13kdI275d1FWwSKR">/pages/pdZr13kdI275d1FWwSKR</a></td></tr><tr><td><h4><i class="fa-terminal">:terminal:</i></h4></td><td><strong>API 參考</strong></td><td>所有端點、參數與錯誤碼。</td><td><a href="/pages/ENpILCR0cyLHZ3mzFJQ4">/pages/ENpILCR0cyLHZ3mzFJQ4</a></td></tr></tbody></table>

## API 模組總覽

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

| 分類                       | 涵蓋內容                   | 文件                                                                                                                                                                                 |
| ------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Assets & Market Data** | 支援的鏈與幣種、資產識別解析、美元計價    | [幣種與鏈](/documentation/assets-and-market-data/assets.md)、[匯率行情](/documentation/assets-and-market-data/rates.md)                                                                     |
| **On-chain Data**        | 交易明細、對手方、歷史餘額、持倉排行與集中度 | [地址活動查詢](/documentation/on-chain-data/address-activity.md)、[持有者與集中度](/documentation/on-chain-data/token-holders.md)                                                                |
| **Risk & Intelligence**  | 地址標籤身分、ML 地址分類、行為風險評分  | [地址標籤](/documentation/risk-and-intelligence/labels.md)、[地址風險](/documentation/risk-and-intelligence/address-risk.md)、[地址分類](/documentation/risk-and-intelligence/classification.md) |
| **Investigation**        | 多跳金流展開、Bitcoin 找零偵測    | [智能追蹤](/documentation/investigation/trace.md)、[Bitcoin 分析](/documentation/investigation/bitcoin.md)                                                                                |
| **Cross-chain**          | 跨鏈橋接續追蹤                | [跨鏈追蹤](/documentation/cross-chain/cross-chain.md)                                                                                                                                  |
| **Address Utilities**    | 地址驗證、糾錯、前綴自動完成         | [地址工具](/documentation/address-utilities/search.md)                                                                                                                                 |
| **Events**               | Webhook 事件推播、即時串流      | [Webhook 訂閱](/documentation/events/webhooks.md)、[即時串流](/documentation/events/streaming.md)                                                                                         |

## 服務特色

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

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

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

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

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

{% hint style="success" %}
想直接試打 API？可從 API Reference 複製範例請求 [`/docs`](https://api.blockchainsecurity.asia/docs)，或下載 OpenAPI 規格匯入 Postman、Swagger UI 等工具進行測試 [`/api-docs/openapi.json`](https://api.blockchainsecurity.asia/api-docs/openapi.json)。
{% endhint %}