地址類型分類

使用機器學習判斷一批地址可能屬於的類型，例如交易所、DeFi 或混幣器，並回傳信心分數。單次最多 100 個地址。

本端點只看鏈上行為特徵做統計推測，不查情資庫、不回風險分數。要「這個地址是誰」請用 /v1/labels；要可量化的風險結論請用 /v1/address-risk。

結果順序與請求的 addresses 一致。單一地址分析失敗時該筆的 predicted_class 為 null、 error 有值，整批仍回 200——請逐筆檢查而不是只看 HTTP 狀態碼。

post

Authorizations

X-API-KeystringRequired

Body

POST /v1/address-classify 的請求 body。

addressesstring[]Required

要分類的地址清單。不可為空，單次最多 100 筆，且格式須與 blockchain 相符。

blockchainstringOptional

區塊鏈網路名稱。支援 tron（預設）、ethereum、bitcoin。

省略時為 tron——若你送的是其他鏈的地址，會因格式不符而回 400，不會被誤判成 Tron 地址。

Example: tron

Responses

200

分類完成，回傳每個地址的預測類型與信心分數

application/json

統一成功回應信封。

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

400

請求參數有誤：缺少必填欄位、鏈別不支援、地址清單為空或超過 100 筆，或地址格式與鏈不符

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

post/v1/address-classify

POST /v1/address-classify HTTP/1.1
Host: api.blockchainsecurity.asia
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "addresses": [
    "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
  ],
  "blockchain": "tron"
}

{
  "data": {
    "results": [
      {
        "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "confidence": 0.9811,
        "error": null,
        "predicted_class": "Defi"
      },
      {
        "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
        "confidence": 0.4132,
        "error": null,
        "predicted_class": "Unknown"
      },
      {
        "address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb",
        "confidence": 0,
        "error": "feature collection failed for this address",
        "predicted_class": null
      }
    ]
  },
  "meta": {
    "request_id": "85ebb9f5-36e4-41c7-a890-2df10f972250"
  }
}