> 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/readme.md).

# BCS Intelligence API Docs

一站式鏈上數據與情資 API 為政府單位、交易所、銀行、託管機構與量化基金提供地址標籤、風險評分、資金流向與交易行為等鏈上情報能力，適用於 KYT / AML 合規、投資研究與交易策略等多元場景。

* **情資地址標籤** — 識別交易對手身分
* **風險分數** — 即時評估地址風險等級
* **資金流向** — 追蹤鏈上資金路徑
* **制裁名單比對** — 自動篩查 OFAC 等制裁清單
* **交易行為分析** — 偵測異常交易模式
* **鏈上情資** — 整合多鏈情報數據

<button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">問我任何問題…</button>

<button type="button" class="button secondary" data-action="ask" data-query="我要如何開始使用 BCS Intelligence API？" data-icon="rocket-launch">快速開始 — 5 分鐘串接第一支 API</button><button type="button" class="button secondary" data-action="ask" data-query="我要如何用 API key 認證？" data-icon="key">API 認證 — 取得您的 API Key</button><button type="button" class="button secondary" data-action="ask" data-query="Credit 計費怎麼算？" data-icon="coins">方案與計費 — 查看使用額度與價格</button>

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>開發者文件</strong></td><td>從第一次呼叫到進階整合。</td><td><a href="https://docs.blockchainsecurity.asia/documentation">https://docs.blockchainsecurity.asia/documentation</a></td><td><a href="https://4062252859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Sit3GHqnqu0owamQr9R%2Fuploads%2FUiGD1ZGIu8bcYtmfUdlL%2FImg_1.png?alt=media&amp;token=a1b14ebe-8d1d-4289-80a5-e3f207aa7e72">Img_1.png</a></td></tr><tr><td><strong>API 參考</strong></td><td>瀏覽、測試並串接所有端點。</td><td><a href="https://docs.blockchainsecurity.asia/api-reference">https://docs.blockchainsecurity.asia/api-reference</a></td><td><a href="https://4062252859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Sit3GHqnqu0owamQr9R%2Fuploads%2FkaUjZ6P1yOPrtw79lw4U%2FImg_2.png?alt=media&amp;token=46746b76-376d-4d87-9802-d9d29b0a1ca1">Img_2.png</a></td></tr><tr><td><strong>說明中心</strong></td><td>查詢常見問題、排解疑難。</td><td><a href="https://docs.blockchainsecurity.asia/help-center">https://docs.blockchainsecurity.asia/help-center</a></td><td><a href="https://4062252859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Sit3GHqnqu0owamQr9R%2Fuploads%2FXNIU76sxGR21EJAxWOtj%2FImg_3.png?alt=media&amp;token=907b4e12-544d-44bf-84cd-75b16a5524d3">Img_3.png</a></td></tr></tbody></table>

{% columns %}
{% column width="50%" %}

## 五分鐘內開始

只要一把 API key，就能發出第一個請求。

BCS Intelligence API 提供企業級鏈上情資與風險 API。透過單一 API key，即可查詢地址風險分數、制裁命中、黑名單標籤、資金流向與交易行為，協助交易所、銀行、託管與支付業者建立 KYT / AML / 鏈上風控流程。

{% hint style="info" icon="sparkle" %}
統一回應格式（Response Envelope）

所有成功回應都包含 data 與 meta；所有錯誤回應都包含 error、code、message 與 request\_id，方便工程、風控與稽核追蹤同一筆請求。
{% endhint %}

{% hint style="success" icon="key" %}
**用量計費，成功才扣**

以 credit 計價，只有成功的 2xx 回應才扣點。每次回應都會附上 credits\_used、remaining\_credits 與 request\_id，方便成本控管與對帳。
{% endhint %}
{% endcolumn %}

{% column width="50%" %}
{% stepper %}
{% step %}

#### 取得 API key

請你方管理員在管理後台建立一把 key，並保存一次性回傳的明碼。
{% endstep %}

{% step %}

#### 發出第一個地址風險查詢

把 key 放進 X-API-Key header，即可呼叫 Address Risk API。

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X POST "https://api.blockchainsecurity.asia/v1/address-risk" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blockchain": "tron",
    "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9"
  }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

url = "https://api.blockchainsecurity.asia/v1/address-risk"

headers = {
    "X-API-Key": "ak_live_YOUR_KEY",
    "Content-Type": "application/json"
}

payload = {
    "blockchain": "tron",
    "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### 看懂回應

以下為地址風險查詢的範例回應（節錄）。實際結果會依鏈別、地址與資料更新時間而不同，完整欄位見[地址風險](https://docs.blockchainsecurity.asia/documentation/lian-shang-api-mo-zu/address-risk)。

```json
{
  "data": {
    "chain": "tron",
    "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
    "risk_score": 26.78,
    "risk_level": "low",
    "risk_level_zh": "低",
    "behaviors": [
      {
        "code": "rapid_in_out",
        "name_zh": "快速進出",
        "severity": "high",
        "score": 12.0,
        "occurrence_count": 8,
        "evidence": {
          "out_ratio": 9.99,
          "window_minutes": 30
        }
      }
    ]
  },
  "meta": { "request_id": "6c41c310-6a01-4c3e-8253-13e7c23e148a" }
}
```

{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}