# 地址標籤

查詢地址在各情報來源的標籤與分類（如交易所、風險評級）。成功扣 **5 credit**，回應包在 `{ data, meta }` 信封。

## 查標籤

```bash
curl "https://api.atlantis.example/v1/labels?chain=ethereum&address=0x28c6c06298d514db089934071355e5743bf21d60" \
  -H "X-API-Key: ak_live_YOUR_KEY"
```

| 參數        | 必填 | 說明                                    |
| --------- | -- | ------------------------------------- |
| `chain`   | 是  | 鏈別（ethereum / bsc / tron / bitcoin …） |
| `address` | 是  | 查詢地址                                  |
| `sources` | 否  | 來源；省略=預設來源，`all`=全部，或逗號分隔             |
| `refresh` | 否  | `true` 跳過快取重新查詢                       |

```json
{
  "data": {
    "chain": "ethereum",
    "address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "results": [
      {
        "source": "misttrack",
        "status": "ok",
        "category": "exchange",
        "name": "Binance",
        "labels": ["Binance", "hot"],
        "raw": { "...": "原始來源回應" },
        "fetched_at": 1700000000,
        "cached": false
      }
    ],
    "fetched_at": 1700000000
  },
  "meta": { "request_id": "..." }
}
```

`results` 為陣列，每個來源同一外殼：

| 欄位         | 說明                                     |
| ---------- | -------------------------------------- |
| `source`   | 來源名稱                                   |
| `status`   | `ok` / `unknown` / `error` / `timeout` |
| `category` | 正規化分類（exchange / mixer …）              |
| `name`     | 名稱（如 Binance）                          |
| `labels`   | 標籤清單                                   |
| `raw`      | 來源原始回應（零失真保留）                          |
| `cached`   | 此來源是否來自快取                              |

## 端點與計費

| Method | 路徑           | 說明     | Credit |
| ------ | ------------ | ------ | ------ |
| `GET`  | `/v1/labels` | 地址情報標籤 | 5      |


---

# 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/zi-liao-api/labels.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.