# 資料 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockchainsecurity.asia/changelog/2026/data-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.