# 歡迎

歡迎使用 **Blockchain Atlantis API Gateway**——面向企業與政府的區塊鏈服務統一接入層。透過單一組 API key，你就能以一致的方式存取我們的區塊鏈資料與情報服務，並自動獲得認證、限流、計費與審計等企業級保障。

這份文件帶你從第一次呼叫，到認證、計費、即時推送等進階主題。

{% hint style="info" %}
本文件中所有範例使用的服務網址 `https://api.atlantis.example` 為示意位址，請替換成你的客戶經理提供的正式 base URL。
{% 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

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>幣種與鏈</strong></td><td>支援的鏈、token registry、資產解析。</td><td><a href="/pages/tTT6DJFlWgHTvw0ZDKao">/pages/tTT6DJFlWgHTvw0ZDKao</a></td></tr><tr><td><strong>地址活動</strong></td><td>交易列表、交易對手、歷史餘額、總覽。</td><td><a href="/pages/BD0J1rce1vyIB0JFwLjN">/pages/BD0J1rce1vyIB0JFwLjN</a></td></tr><tr><td><strong>持有者與集中度</strong></td><td>Token 持有排行與集中度（HHI/Gini）。</td><td><a href="/pages/I9D0TyGEqkVd3NiS8Q9A">/pages/I9D0TyGEqkVd3NiS8Q9A</a></td></tr><tr><td><strong>地址標籤</strong></td><td>交易所 / 風險等情報標籤。</td><td><a href="/pages/DpK7tFEjOuBs4OHXEQSD">/pages/DpK7tFEjOuBs4OHXEQSD</a></td></tr><tr><td><strong>地址搜尋</strong></td><td>模糊搜尋與前綴自動完成。</td><td><a href="/pages/hAZ7Y87l3Jk60QcUtWT5">/pages/hAZ7Y87l3Jk60QcUtWT5</a></td></tr><tr><td><strong>匯率行情</strong></td><td>幣種 USD 時點 / 歷史查價。</td><td><a href="/pages/sxVuhB1CZpb5n0N8ze1W">/pages/sxVuhB1CZpb5n0N8ze1W</a></td></tr></tbody></table>

## 服務特色

* **統一接入** — 一組 `X-API-Key`、一致的 `{ data, meta }` 回應信封，所有服務共用同一套規則。
* **用量計費** — 以 credit 計價，**只有成功的回應才扣點**，每次回應都附上本次成本與剩餘餘額。
* **彈性限流** — 依 API key 與端點分別限流，超量時可選擇直接拒絕或在佇列內等待。
* **可追溯** — 每個請求都有 `X-Request-Id`，並寫入審計紀錄，方便事後對帳與稽核。
* **即時推送** — 透過 Webhook 與 WebSocket 取得鏈上事件的即時通知。

{% hint style="success" %}
想直接試打 API？線上互動式文件（含「試一試」功能）位於 [`/docs`](https://api.atlantis.example/docs)，原始 OpenAPI 規格在 [`/api-docs/openapi.json`](https://api.atlantis.example/api-docs/openapi.json)。
{% endhint %}


---

# 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/documentation/readme.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.