> 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

* **情資地址標籤** — 識別交易對手身分
* **風險分數** — 即時評估地址風險等級
* **資金流向** — 追蹤鏈上資金路徑
* **制裁名單比對** — 自動篩查 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="/files/QGqpShJHbFuUJu4euL1y">/files/QGqpShJHbFuUJu4euL1y</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="/files/FuUnlpoyHgkbfWeKDh7a">/files/FuUnlpoyHgkbfWeKDh7a</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="/files/Qdy9byrfngL0nWjVaffm">/files/Qdy9byrfngL0nWjVaffm</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 %}