多跳資金追蹤

從指定地址向外或向內逐跳追蹤資金，自動展開多層流向，並可依資產與金額條件篩選。適合調查資金來源與最終去向。

post

Authorizations

X-API-KeystringRequired

Body

智能追蹤的請求參數。

track_setting（時間範圍、向外 / 向內追蹤深度、回傳筆數上限、金額累計…）、 filter_criterias（金額 / 幣別篩選）、stop_track_condition（停止追蹤條件）皆為選填； 未提供時以預設行為追蹤。

addressstringRequired

起始追蹤地址。

blockchainstringRequired

鏈別（tron / ethereum / bitcoin）。

filter_criteriasanyOptional

金額篩選條件陣列（symbol / min_value / max_value / sign）。

stop_track_conditionanyOptional

停止追蹤條件（預留）。

track_settinganyOptional

追蹤參數（時間範圍、往外/往內深度、limit、金額累計等）。

Responses

200

追蹤成功，回傳展開的金流路徑與相關交易

application/json

400

請求參數有誤，請提供 blockchain 與 address

401

缺少或無效的 API key

502

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

post/v1/trace

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

{
  "address": "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
  "blockchain": "tron",
  "filter_criterias": [
    {
      "max_value": 700,
      "min_value": 496,
      "sign": "range",
      "symbol": "usdt"
    }
  ],
  "track_setting": {
    "enable_amount_aggregation": true,
    "endTime": 1721318399,
    "inbound_depth": 1,
    "limit": 5,
    "outbound_depth": 3,
    "startTime": 1721145600
  }
}

{
  "data": {
    "result": {
      "address": "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
      "blockchain": "tron",
      "errors": [],
      "filter_criteria": {
        "max": 700,
        "max_inclusive": true,
        "min": 496,
        "min_inclusive": true,
        "sign": "range",
        "symbol": "usdt",
        "value": 0,
        "variation": 0
      },
      "filter_criterias": [
        {
          "max": 700,
          "max_inclusive": true,
          "min": 496,
          "min_inclusive": true,
          "sign": "range",
          "symbol": "usdt",
          "value": 0,
          "variation": 0
        }
      ],
      "internal": [],
      "limit": 5,
      "normal": [],
      "offset": 17,
      "page": 0,
      "path_summaries": [
        {
          "anchor_address": "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
          "anchor_tx_hash": "21b9d56f509ff854ca15dbda7254810a33525604553c7ccf3c72eccf35bc5464",
          "attribution_confidence": "high",
          "edge_uids": [
            "69a5837f94a25852193a9f0259b53428-0"
          ],
          "endpoint_label": "Okx",
          "endpoint_node": "THXN4jourpQJkdQsS3g8FgnoCgibHsrzhh",
          "hop_count": 0,
          "is_exchange": true,
          "is_service": false,
          "node_uids": [
            "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
            "THXN4jourpQJkdQsS3g8FgnoCgibHsrzhh"
          ],
          "path_confidence": 1,
          "stop_reason": "endpoint:exchange:Okx",
          "stop_rule": "RULE-B4"
        },
        {
          "anchor_address": "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
          "anchor_tx_hash": "d045f7a2d4ebdfd3f679c650c0a465fe07400b06cb4143fea36b92a63161b8cf",
          "attribution_confidence": "high",
          "edge_uids": [
            "20919ada536491041a99e8193fd0e856-0"
          ],
          "endpoint_label": "Okx",
          "endpoint_node": "TTrwyjyiiYmJhjnZB7PNyLGERVVxdhDCZp",
          "hop_count": 0,
          "is_exchange": true,
          "is_service": false,
          "node_uids": [
            "TDZmNAhbGrrSzZZ8JJx1E3YhnSQ9TZQtYy",
            "TTrwyjyiiYmJhjnZB7PNyLGERVVxdhDCZp"
          ],
          "path_confidence": 1,
          "stop_reason": "endpoint:exchange:Okx",
          "stop_rule": "RULE-B4"
        }
      ],
      "source": "backup",
      "token": [],
      "transactions": [
        {
          "amount": "315.44000000",
          "blockchain": "tron",
          "edge_score": 0.7694133802388052,
          "fee": 0,
          "from": {
            "address": "TYRbMsM5tjfArgjJ9YKuXd4jHijZwbqLMn",
            "blackList": false,
            "blockchain": "tron",
            "label": [
              "Unknown"
            ],
            "name": "Unknown",
            "smartContract": false,
            "type": "Address"
          },
          "graph_type": "Txn",
          "log_index": "0",
          "rules_hit": [
            "RULE-T1-S1",
            "RULE-A2"
          ],
          "symbol": "usdt",
          "timestamp": 1721189376,
          "to": {
            "address": "TLTXcvxJLw9HGWP8FDdp42E3GcXikbQhPS",
            "blackList": false,
            "blockchain": "tron",
            "label": [
              "Binance"
            ],
            "name": "Binance",
            "smartContract": false,
            "type": "Deposit"
          },
          "tokenAddress": "",
          "tx_hash": "a20606edbf220503ed16ad535e1a7503483fa8c789109d9b3d1d3cee33fd2673",
          "txn_type": "token",
          "uid": "261119e760b6ec5392731b99808e9c79-0",
          "value": "315.44000000"
        },
        {
          "amount": "480.00000000",
          "blockchain": "tron",
          "edge_score": 0.6326029437906675,
          "fee": 0,
          "from": {
            "address": "TEa9JdwCgyRn7VUUYM2oLoD73CzYdUrxuq",
            "blackList": false,
            "blockchain": "tron",
            "label": [
              "Unknown"
            ],
            "name": "Unknown",
            "smartContract": false,
            "type": "Address"
          },
          "graph_type": "Txn",
          "log_index": "0",
          "rules_hit": [
            "RULE-T1-S2",
            "RULE-A2"
          ],
          "symbol": "usdt",
          "timestamp": 1721205990,
          "to": {
            "address": "TCCGqJChg2KScFPqFhBHw9h6A2dyYtkFec",
            "blackList": false,
            "blockchain": "tron",
            "label": [
              "Unknown"
            ],
            "name": "Unknown",
            "smartContract": false,
            "type": "Address"
          },
          "tokenAddress": "",
          "tx_hash": "8f63a32e166c06a9170a2c355224e089774610ab92b5d4bff01a8e651caf2b43",
          "txn_type": "token",
          "uid": "449af75fe7bd8e356818d675fc7bf7c6-0",
          "value": "480.00000000"
        }
      ]
    },
    "timestamp": 1783332677
  },
  "meta": {
    "request_id": "8fa3f884-709d-442d-a33f-7255a6d8faab"
  }
}