地址標籤與身分

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

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

get

Authorizations

X-API-KeystringRequired

Query parameters

chainstringRequired

鏈別。支援 ethereum、tron、bitcoin、bsc、polygon、avalanche、base（可用 eth / btc / bnb 等常見別名）

Example: ethereum

addressstringRequired

查詢地址。格式須與 chain 相符，否則回 400

Example: 0x28c6c06298d514db089934071355e5743bf21d60

sourcesstringOptional

查詢範圍。all（預設）＝自有情資庫加外部來源；first_party＝只查自有情資庫（較快，不消耗外部查詢額度）

Example: all

Responses

200

查詢成功

application/json

統一成功回應信封。

• data：實際的業務資料（泛型 T，必須可序列化）。
• meta：與這次請求有關的中繼資訊（request id、分頁、credit 用量等）。

400

請求參數有誤：缺少必填參數、chain 不支援、address 格式與 chain 不符，或 sources 值無效

application/json

401

缺少或無效的 API key

application/json

402

點數餘額不足

application/json

403

目前方案不含此端點

application/json

429

請求過於頻繁，請依 Retry-After 退避後重試

application/json

500

伺服器內部錯誤

application/json

502

後端服務暫時無法回應，請稍後重試

application/json

503

後端服務暫時過載，請退避後重試

application/json

504

查詢逾時，請稍後重試

application/json

get/v1/labels

GET /v1/labels?chain=text&address=text HTTP/1.1
Host: api.blockchainsecurity.asia
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "address": "0x28c6c06298d514db089934071355e5743bf21d60",
    "chain": "ethereum",
    "fetched_at": 1783332664,
    "label": {
      "confidence": 1,
      "entity_name": "Binance",
      "labels": [
        "exchange",
        "exchange_hot_wallet"
      ]
    }
  },
  "meta": {
    "request_id": "03ca1bda-ebb1-40e8-bf99-387ee3efe341"
  }
}