API 參考

鏈上合規與風險評估的 REST API。

基礎 URL

https://api.fidesorigin.com/api/v1

認證

所有 API 請求需要在 Authorization 頭中攜帶 Bearer token。

Header

Authorization: Bearer YOUR_API_KEY

接口

GET /addresses/{address}

獲取指定以太坊地址的風險檔案。

響應

JSON

{
  "address": "0x...",
  "risk_score": 85,
  "risk_tier": "HIGH",
  "is_sanctioned": false,
  "tags": ["mixer", "high_volume"],
  "entity_name": "Unknown",
  "last_updated": "2026-07-24T09:00:00Z"
}

POST /risk-assessment

在執行前提交交易進行風險評估。

請求體

JSON

{
  "from": "0x...",
  "to": "0x...",
  "amount": "1000000000000000000",
  "asset": "0x..."
}

響應

JSON

{
  "allowed": true,
  "risk_score": 15,
  "risk_tier": "LOW",
  "quarantine_required": false,
  "reason": null
}

GET /rules

列出所有活躍的合規規則。

響應

JSON

{
  "rules": [
    {
      "id": "rule-001",
      "name": "Sanctions Screening",
      "type": "BLOCK",
      "active": true,
      "priority": 1
    }
  ]
}

錯誤碼

代碼	狀態	描述
`400`	Bad Request	請求參數無效
`401`	Unauthorized	缺少或無效的 API 密鑰
`404`	Not Found	地址或資源未找到
`429`	Rate Limited	請求過於頻繁
`500`	Server Error	內部伺服器錯誤