> 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/changelog/2026/data-apis.md).

# 資料 API 上線

在統一閘道之上新增一整批區塊鏈資料查詢端點。全部走同一把 `X-API-Key`、`{ data, meta }` 信封、credit 計費與 `X-Request-Id` 追蹤；線上互動式文件見 `/docs`。

### 幣種與鏈（免費）

* `GET /v1/chains` — 支援的鏈與幣種
* `GET /v1/registry` — 完整 token registry
* `GET /v1/assets?chain=` — 某鏈的代幣
* `POST /v1/resolve` — `symbol` / 合約 → 資產規格（含 decimals）

### 地址活動

* `POST /v1/transactions` — 交易列表
* `POST /v1/counterparty` — 交易對手排行
* `POST /v1/counterparty/transfer-between` — 兩地址交易明細
* `POST /v1/counterparty/overview` — 兩地址聚合統計
* `POST /v1/balance-history` — 每日歷史餘額
* `POST /v1/wallet-overview` — 地址總覽

### Token 持有結構

* `GET /v1/token/holders` — 持有者排行
* `GET /v1/token/concentration` — 集中度（HHI / Gini / Top-N 占比、有效持有人數）

### 情報與搜尋

* `GET /v1/labels` — 地址情報標籤（交易所 / 風險等，多來源）
* `GET /v1/addresses/resolve` — 地址驗證 / 糾錯
* `GET /v1/addresses/autocomplete` — 前綴自動完成（免費）

### 匯率行情

* `GET /v1/rates` — 時點 / 最新查價（批次）
* `GET /v1/rates/history` — 歷史價序列
* `GET /v1/rates/symbols` — 有資料的幣種

<details>

<summary>計費（credit）</summary>

* **免費（0）**：chains、registry、assets、resolve、addresses/autocomplete、rates、rates/symbols
* **5**：transactions、counterparty 系、balance-history、wallet-overview、labels、addresses/resolve、rates/history
* **10 / 15**：token/holders（10）、token/concentration（15）——查詢較重

</details>