> 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/api-reference/readme/risk-and-intelligence/di-zhi-biao-qian-yu-shen-fen.md).

# 地址標籤與身分

查詢地址已知標籤與身分類型，例如交易所、混幣器或 DeFi。回傳實體名稱、分類、信心度與驗證狀態，並提示是否需要進一步分析。

查得到地址但沒有任何標籤是正常結果（`label` 只剩 `confidence: 0.0`），代表 「目前無情資」，不代表該地址安全。需要風險判定請走 `/v1/address-risk`。

## GET /v1/labels

>

```json
{"openapi":"3.1.0","info":{"title":"Blockchain Atlantis API Gateway","version":"0.1.0"},"tags":[{"description":"查詢地址已知標籤與身分類型，例如交易所、混幣器或 DeFi。回傳實體名稱、分類、信心度與驗證狀態，並提示是否需要進一步分析。\n\n查得到地址但沒有任何標籤是正常結果（`label` 只剩 `confidence: 0.0`），代表\n「目前無情資」，不代表該地址安全。需要風險判定請走 `/v1/address-risk`。","name":"地址標籤與身分"}],"servers":[{"description":"Production","url":"https://api.blockchainsecurity.asia"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"in":"header","name":"X-API-Key","type":"apiKey"}},"schemas":{"AggregateLabel":{"description":"綜合標籤。","properties":{"confidence":{"description":"綜合信心，0.0–1.0。多方一致或經我方驗證會拉高；單一來源、未經驗證會偏低。\n沒有任何命中時為 `0.0`。","format":"double","type":"number"},"entity_name":{"description":"實體名稱，例如 `Binance`。無法判定時不出現。","type":["string","null"]},"labels":{"description":"這個地址的身分與行為標籤（小寫 snake_case 代碼，去重、保序）。\n\n一個地址可以同時有多個標籤，而且它們分屬不同面向——身分（`exchange`、\n`dex`、`mixer`）、行為（`mev_bot`、`sandwich_attack`）、風險\n（`sanction`、`phishing`）、資金流形態（`peel_chain`）與活躍度\n（`dormant`）。這些**不互斥**，請逐一比對需要的標籤，不要假設只有一個。\n\n查無情資時為空陣列（欄位不出現）。","items":{"type":"string"},"type":"array"}},"required":["confidence"],"type":"object"},"Meta":{"description":"回應的中繼資訊。所有欄位都是 `Option`，沒有的就不會出現在 JSON 裡\n（搭配 `skip_serializing_if`），維持輸出乾淨。","properties":{"credit_cost":{"description":"本次請求扣掉的 credit 數量（計費後填入）。","format":"int64","type":["integer","null"]},"credit_remaining":{"description":"本次請求後剩餘的 credit 餘額。","format":"int64","type":["integer","null"]},"pagination":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/PaginationMeta","description":"分頁資訊（僅列表型 endpoint 會帶）。"}]},"request_id":{"description":"本次請求的唯一識別碼，與 log / 追蹤系統對應，方便客訴時定位。","type":["string","null"]}},"type":"object"},"PaginationMeta":{"description":"對外的分頁中繼資訊。","properties":{"limit":{"format":"int32","minimum":0,"type":"integer"},"offset":{"format":"int32","minimum":0,"type":"integer"},"total":{"description":"符合條件的總筆數（若下游能提供）。","format":"int64","minimum":0,"type":["integer","null"]}},"required":["limit","offset"],"type":"object"},"ErrorResponse":{"description":"對外錯誤信封。與成功回應的 [`crate::response::ApiResponse`] 結構對稱，\n客戶端永遠拿到 `{ \"error\": { \"code\": ..., \"message\": ... } }`。\n\n同時是 OpenAPI 的錯誤 schema：所有非 2xx 回應都是這個形狀，端點文件以\n`body = ErrorResponse` 引用它，客戶端只要寫一次錯誤解析。","properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}},"required":["error"],"type":"object"},"ErrorDetail":{"description":"錯誤本體。`code` 是穩定的機器可讀字串（比 HTTP 狀態碼細緻），\n`message` 是給人看的說明，不保證格式穩定——請用 `code` 做程式判斷。","properties":{"code":{"description":"機器可讀錯誤碼，例如 `bad_request` / `insufficient_credit` / `gateway_timeout`。","type":"string"},"message":{"description":"人可讀的錯誤說明。","type":"string"}},"required":["code","message"],"type":"object"}}},"paths":{"/v1/labels":{"get":{"operationId":"labels","parameters":[{"description":"鏈別。支援 ethereum、tron、bitcoin、bsc、polygon、avalanche、base（可用 eth / btc / bnb 等常見別名）","in":"query","name":"chain","required":true,"schema":{"type":"string"}},{"description":"查詢地址。格式須與 chain 相符，否則回 400","in":"query","name":"address","required":true,"schema":{"type":"string"}},{"description":"查詢範圍。all（預設）＝自有情資庫加外部來源；first_party＝只查自有情資庫（較快，不消耗外部查詢額度）","in":"query","name":"sources","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"description":"統一成功回應信封。\n\n- `data`：實際的業務資料（泛型 `T`，必須可序列化）。\n- `meta`：與這次請求有關的中繼資訊（request id、分頁、credit 用量等）。","properties":{"data":{"description":"地址標籤查詢結果。","properties":{"address":{"description":"查詢的地址。","type":"string"},"chain":{"description":"查詢的鏈別（正規化後）。","type":"string"},"fetched_at":{"description":"本次結果產生時間（Unix epoch 秒，UTC）。","format":"int64","type":"integer"},"label":{"$ref":"#/components/schemas/AggregateLabel","description":"綜合標籤：各來源結果彙整後的單一結論。"}},"required":["chain","address","label","fetched_at"],"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"type":"object"}}},"description":"查詢成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"請求參數有誤：缺少必填參數、chain 不支援、address 格式與 chain 不符，或 sources 值無效"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"缺少或無效的 API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"點數餘額不足"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"目前方案不含此端點"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"請求過於頻繁，請依 Retry-After 退避後重試"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"伺服器內部錯誤"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"後端服務暫時無法回應，請稍後重試"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"後端服務暫時過載，請退避後重試"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"查詢逾時，請稍後重試"}},"summary":"","tags":["地址標籤與身分"]}}}}
```