多地址資金流

查詢指定代幣在一批地址間、特定時間區間內的資金流動。回傳各地址收入、支出、淨流量與整體加總，單次最多 100 個地址。

get

Authorizations

X-API-KeystringRequired

Path parameters

blockchainstringRequired

鏈名稱（ethereum / tron / bitcoin）。

Example: ethereum

contractstring · nullableRequired

合約地址（ethereum / tron 必填，bitcoin 必須省略）。

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

addressesstringRequired

Comma-separated 地址清單（1..=100）。

Example: 0xf977814e90da44bfa03b6295a0616a897441acec,0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503

from_tsinteger · int64Required

區間起點 unix timestamp（秒）。

Example: 1704067200

to_tsinteger · int64Required

區間終點 unix timestamp（秒）。to_ts - from_ts ≤ 365 天。

Example: 1735603200

Responses

200

查詢成功，回傳每個地址的資金流向與整體加總

application/json

統一成功回應信封。

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

400

請求參數有誤（地址清單為空或超過 100 個、時間區間超過 365 天、或鏈別不符），請檢查輸入內容

401

缺少或無效的 API key

402

點數餘額不足

429

請求過於頻繁，請稍後重試

502

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

get/v1/token/addresses_flow

GET /v1/token/addresses_flow HTTP/1.1
Host: api.blockchainsecurity.asia
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "address_count": 2,
    "aggregate": {
      "net_flow_total": 0,
      "net_flow_total_usd": 0,
      "received_total": 0,
      "sent_total": 0,
      "tx_count_total": 0
    },
    "blockchain": "tron",
    "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "decimals": 6,
    "from_ts": 1721145600,
    "meta": {
      "cached": true,
      "cost_class": "light",
      "query_duration_ms": 6
    },
    "results": [
      {
        "address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
        "first_activity_ts": null,
        "last_activity_ts": null,
        "net_flow": 0,
        "net_flow_usd": 0,
        "received": 0,
        "received_count": 0,
        "sent": 0,
        "sent_count": 0,
        "tx_count": 0
      },
      {
        "address": "TAUN6FwrnwwmaEqYcckffC7wYmbaS6cBiX",
        "first_activity_ts": null,
        "last_activity_ts": null,
        "net_flow": 0,
        "net_flow_usd": 0,
        "received": 0,
        "received_count": 0,
        "sent": 0,
        "sent_count": 0,
        "tx_count": 0
      }
    ],
    "symbol": "USDT",
    "to_ts": 1721318399
  },
  "meta": {
    "request_id": "f787d577-a307-4773-a4da-4448f516db07"
  }
}