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	内部服务器错误