Developer API

MAX 會員專屬的金流追蹤 API。

使用 API key 從外部 CRM、客服後台或合規系統建立案件、查詢狀態、讀取調查摘要與搜尋候選交易。

管理 API Key 查看 MAX 權益

認證與限流

API 僅開放 MAX、B2B 與 Admin。每支 key 只在建立時顯示一次，後端只保存 salted hash。

Header

X-FlowTrace-API-Key: ft_live_...

替代格式

Authorization: Bearer ft_live_...

限流

300/hour general, 60/hour case create, 120/hour candidate lookup

端點

Method	Path	用途
GET	/api/v1/me	讀取方案權益、API 權限與 key 容量。
GET	/api/v1/cases	列出 API key 擁有者可見的案件。
POST	/api/v1/cases	用 chain、token、address、tx hash 與 depth 建立追蹤案件。
GET	/api/v1/cases/{case_id}	讀取案件基本資料。
GET	/api/v1/cases/{case_id}/status	讀取目前爬取狀態與進度。
GET	/api/v1/cases/{case_id}/investigation	讀取歸因提示、警示與調查摘要。
GET	/api/v1/quota	讀取帳號剩餘案件額度。
POST	/api/v1/candidate-transactions	用受害者報案資料或貼上的證據搜尋候選交易。

範例

列出案件

curl https://api.flowtracelabs.com/api/v1/cases \
  -H "X-FlowTrace-API-Key: ft_live_..."

建立案件

curl https://api.flowtracelabs.com/api/v1/cases \
  -H "X-FlowTrace-API-Key: ft_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Victim report 2026-06",
    "chain": "tron",
    "token": "USDT",
    "start_address": "T...",
    "start_tx_hash": "64-char hash",
    "max_depth": 3
  }'

查詢候選交易

curl https://api.flowtracelabs.com/api/v1/candidate-transactions \
  -H "Authorization: Bearer ft_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "tron",
    "token": "USDT",
    "address": "T...",
    "amount": "1000",
    "limit": 25
  }'

常見錯誤

401 api_key_required - 缺少 API key。
401 invalid_api_key - key 無效或已撤銷。
403 api_access_requires_max - 帳號沒有 MAX/API 權限。
429 rate_limited - 超過限流。

前往設定頁