> 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/investigation/duo-tiao-zi-jin-zhui-zong.md).

# 多跳資金追蹤

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

## POST /v1/trace

>

```json
{"openapi":"3.1.0","info":{"title":"Blockchain Atlantis API Gateway","version":"0.1.0"},"tags":[{"description":"從指定地址向外或向內逐跳追蹤資金，自動展開多層流向，並可依資產與金額條件篩選。適合調查資金來源與最終去向。","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":{"TraceRequest":{"description":"智能追蹤的請求參數。\n\n`track_setting`（時間範圍、向外 / 向內追蹤深度、回傳筆數上限、金額累計…）、\n`filter_criterias`（金額 / 幣別篩選）、`stop_track_condition`（停止追蹤條件）皆為選填；\n未提供時以預設行為追蹤。","properties":{"address":{"description":"起始追蹤地址。","type":"string"},"blockchain":{"description":"鏈別（tron / ethereum / bitcoin）。","type":"string"},"filter_criterias":{"description":"金額篩選條件陣列（symbol / min_value / max_value / sign）。"},"stop_track_condition":{"description":"停止追蹤條件（預留）。"},"track_setting":{"description":"追蹤參數（時間範圍、往外/往內深度、limit、金額累計等）。"}},"required":["blockchain","address"],"type":"object"}}},"paths":{"/v1/trace":{"post":{"operationId":"quick","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraceRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{}},"description":"追蹤成功，回傳展開的金流路徑與相關交易"},"400":{"description":"請求參數有誤，請提供 blockchain 與 address"},"401":{"description":"缺少或無效的 API key"},"502":{"description":"後端服務暫時無法回應，請稍後重試"}},"summary":"","tags":["多跳資金追蹤"]}}}}
```