> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/address-screening/get-a-task-result.md).

# 获取任务结果

获取任务的结果。此端点不会消耗您的配额。

## 获取地址筛查任务结果

> 获取已提交的批量地址筛查任务结果。

```json
{"openapi":"3.0.0","info":{"title":"Compliance API","version":"2.0.0"},"tags":[{"name":"地址筛查","description":"地址筛查与查询 API。"}],"servers":[{"url":"https://api.blocksec.com/phalcon/compliance/v2","description":"生产环境服务器"}],"security":[{"API-Key":[]}],"components":{"securitySchemes":{"API-Key":{"type":"apiKey","in":"header","name":"API-Key"}},"schemas":{"ErrorCodeMsg":{"properties":{"code":{"type":"integer"},"msg":{"type":"string"}}},"AddressScreenResult":{"type":"object","properties":{"taskId":{"type":"string","description":"筛查任务唯一标识。同步和异步结果均会返回。"},"address":{"type":"string","description":"已筛查的目标地址。"},"chainId":{"type":"integer","description":"链 ID。关于所有支持的链及对应 chain ID，请查看：[https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/supported-chains](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/supported-chains)。"},"chainName":{"type":"string","description":"区块链名称。"},"label":{"type":"string","description":"目标地址标签（如有）。"},"entity":{"type":"string","description":"与该地址关联的实体（例如：\"Binance\"）。"},"category":{"type":"array","description":"与该实体关联的类别（例如：[\"Exchange\", \"OTC Desk\"]）。","items":{"type":"string"}},"systemTags":{"type":"array","description":"来自地址标签库的地址预定义标记（例如：\"Deposit Address\"）。","items":{"type":"string"}},"userTags":{"type":"array","description":"用户为该地址添加的自定义标记。","items":{"type":"string"}},"note":{"type":"string","description":"用户为该地址添加的备注。"},"customerId":{"type":"string","description":"该地址关联的客户 ID（如有）。通过\"绑定地址到客户\"接口或在平台中手动设置。"},"riskLevel":{"type":"integer","description":"已筛查地址的评估风险等级。"},"riskLevelDescription":{"type":"string","description":"风险等级说明。"},"isBlacklisted":{"type":"boolean","description":"已废弃。该地址是否在你的黑名单中。请改用 `riskProfile.entityRisks`（type=blacklist）。当前仍可使用，预计于 2026-08-31 正式下线。","deprecated":true},"blacklistedInfo":{"type":"string","description":"已废弃。黑名单状态详情。请改用 `riskProfile.entityRisks`（type=blacklist）。当前仍可使用，预计于 2026-08-31 正式下线。","deprecated":true},"isWhitelisted":{"type":"boolean","description":"已废弃。该地址是否在你的白名单中。请改用 `riskProfile.entityRisks`（type=whitelist）。当前仍可使用，预计于 2026-08-31 正式下线。","deprecated":true},"whitelistedInfo":{"type":"string","description":"已废弃。白名单状态详情。请改用 `riskProfile.entityRisks`（type=whitelist）。当前仍可使用，预计于 2026-08-31 正式下线。","deprecated":true},"lastScreenAt":{"type":"integer","description":"该地址最近一次筛查的 UNIX 时间戳。"},"screeningCount":{"type":"integer","description":"该地址的筛查总次数。"},"unresolvedAlerts":{"type":"integer","description":"与该地址关联的未处理告警数量。"},"riskProfile":{"$ref":"#/components/schemas/RiskProfile","description":"按类别（实体风险、交互风险、行为风险）汇总的地址风险发现。始终返回，不受 includeDetails 影响。已过期告警不在此反映。"},"alerts":{"type":"array","description":"与该地址关联的告警。","items":{"$ref":"#/components/schemas/AddressScreenAlert"}}}},"RiskProfile":{"type":"object","description":"按类别汇总的风险发现。始终返回。已过期告警不包含在内。","properties":{"entityRisks":{"type":"array","description":"实体级风险：地址/参与方直接标记的风险指标，以及黑白名单归属。","items":{"$ref":"#/components/schemas/EntityRisk"}},"interactionRisks":{"type":"array","description":"通过资金流向高风险对手方产生的风险敞口，按指标和方向分组。","items":{"$ref":"#/components/schemas/InteractionRisk"}},"behaviorRisks":{"type":"array","description":"在地址/交易上检测到的行为风险。","items":{"$ref":"#/components/schemas/BehaviorRisk"}}}},"EntityRisk":{"type":"object","properties":{"type":{"type":"string","description":"实体风险类型。","enum":["riskIndicator","blacklist","whitelist"]},"riskLevel":{"type":"integer","nullable":true,"description":"风险等级。对于未评分的名单归属条目（如黑名单），值为 null。"},"riskLevelDescription":{"type":"string","description":"风险等级说明。"},"triggered":{"type":"boolean","description":"该风险是否已触发。"},"alertIds":{"type":"array","description":"导致该实体风险的告警列表。","items":{"type":"string"}},"riskIndicator":{"type":"integer","description":"风险指标。当 type 为 riskIndicator 时存在。"},"riskIndicatorDescription":{"type":"string","description":"风险指标说明。当 type 为 riskIndicator 时存在。"},"detail":{"type":"array","description":"补充信息。当 type 为 riskIndicator 时存在。","items":{"type":"string"}},"listName":{"type":"string","description":"名单名称。当 type 为 blacklist 或 whitelist 时存在。"},"reason":{"type":"string","description":"地址加入名单的原因。当 type 为 blacklist 或 whitelist 时存在。"},"operator":{"type":"string","description":"将地址加入名单的操作者。当 type 为 blacklist 或 whitelist 时存在。"},"addedAt":{"type":"integer","format":"int64","description":"地址加入名单的时间，毫秒级 UNIX 时间戳。当 type 为 blacklist 或 whitelist 时存在。"},"address":{"type":"string","description":"该风险所属的参与方地址。仅交易 API 返回。"},"label":{"type":"string","description":"参与方地址标签（如有）。仅交易 API 返回。"}}},"InteractionRisk":{"type":"object","properties":{"indicator":{"type":"integer","description":"风险敞口的风险指标。0 表示用户黑名单敞口。"},"indicatorDescription":{"type":"string","description":"指标说明（例如黑名单敞口时为 \"User Blacklist\"）。"},"direction":{"type":"integer","description":"敞口方向。"},"riskLevel":{"type":"integer","description":"风险等级。"},"riskLevelDescription":{"type":"string","description":"风险等级说明。"},"direct":{"$ref":"#/components/schemas/ExposurePart","description":"直接敞口（1 跳）。"},"indirect":{"$ref":"#/components/schemas/ExposurePart","description":"间接敞口（2 跳及以上）。"},"total":{"$ref":"#/components/schemas/ExposureTotal","description":"总敞口。"},"triggered":{"type":"boolean","description":"该敞口是否已触发。"},"alertIds":{"type":"array","description":"导致该敞口的告警列表。","items":{"type":"string"}}}},"ExposurePart":{"type":"object","properties":{"exposureValue":{"type":"string","description":"风险敞口值（美元）。"},"exposurePercent":{"type":"number","description":"风险敞口百分比。"},"triggered":{"type":"boolean","description":"该部分敞口是否已触发。"}}},"ExposureTotal":{"type":"object","properties":{"exposureValue":{"type":"string","description":"总风险敞口值（美元）。"},"exposurePercent":{"type":"number","description":"总风险敞口百分比。"}}},"BehaviorRisk":{"type":"object","properties":{"behaviorType":{"type":"string","description":"行为风险类型。RapidTransit 仅由交易 API 产生。","enum":["LargeTransfer","HighFrequencyTransfer","TransitAddress","RapidTransit"]},"riskLevel":{"type":"integer","description":"风险等级。"},"riskLevelDescription":{"type":"string","description":"风险等级说明。"},"triggered":{"type":"boolean","description":"该行为风险是否已触发。"},"alertIds":{"type":"array","description":"导致该行为风险的告警列表。","items":{"type":"string"}},"fields":{"$ref":"#/components/schemas/BehaviorRiskFields","description":"行为风险特定字段；具体填充的子集取决于 behaviorType。"}}},"BehaviorRiskFields":{"type":"object","description":"行为风险特定字段。地址 API（聚合多个事件）：LargeTransfer 使用 maxValue、matchedEvents；HighFrequencyTransfer 使用 transferCount、timeWindow、avgInterval、matchedEvents；TransitAddress 使用 maxValue、timeWindow、matchedEvents。交易 API（单个事件）：LargeTransfer 使用 value、amount、token；RapidTransit 使用 value、timeWindow。","properties":{"maxValue":{"type":"string","description":"最大单笔转账美元价值（地址 API）。"},"matchedEvents":{"type":"integer","description":"匹配的事件数量（地址 API）。"},"transferCount":{"type":"integer","description":"转账数量（HighFrequencyTransfer）。"},"timeWindow":{"type":"integer","description":"时间窗口（秒）。"},"avgInterval":{"type":"integer","description":"转账间平均间隔（秒，HighFrequencyTransfer）。"},"value":{"type":"string","description":"事件的美元价值（交易 API）。"},"amount":{"type":"string","description":"转账的代币数量（交易 API，可选）。"},"token":{"type":"string","description":"代币符号（交易 API，可选）。"}}},"AddressScreenAlert":{"type":"object","properties":{"alertId":{"type":"string","description":"告警唯一标识。"},"status":{"type":"integer","description":"告警状态。"},"statusDescription":{"type":"string","description":"告警状态说明。"},"riskLevel":{"type":"integer"},"riskLevelDescription":{"type":"string","description":"风险等级说明。"},"description":{"type":"string","description":"告警描述。"},"firstTriggeredAt":{"type":"integer","format":"int64","description":"告警首次触发时间，秒级 UNIX 时间戳。"},"lastUpdatedAt":{"type":"integer","format":"int64","description":"告警最后更新时间，秒级 UNIX 时间戳。"},"riskActivityTime":{"type":"integer","format":"int64","description":"告警关联的最新风险活动时间，秒级 UNIX 时间戳。"},"riskEngineId":{"type":"string","description":"生成该告警的 Risk Engine 唯一标识。"},"riskEngineName":{"type":"string","description":"生成该告警的 Risk Engine 名称。"},"riskDetail":{"type":"array","deprecated":true,"description":"已废弃。仅在 includeDetails 设为 true 时返回的逐条告警详情。请改用顶层 `riskProfile`。当前仍可使用，预计于 2026-08-31 正式下线。","items":{"oneOf":[{"$ref":"#/components/schemas/EntityRiskData"},{"$ref":"#/components/schemas/InteractionRiskData"},{"$ref":"#/components/schemas/LargeTransferData"},{"$ref":"#/components/schemas/HighFrequencyData"},{"$ref":"#/components/schemas/TransitAddressData"},{"$ref":"#/components/schemas/BlacklistInteractionData"},{"$ref":"#/components/schemas/ParticipantRiskData"},{"$ref":"#/components/schemas/RapidTransitData"}]}}}},"EntityRiskData":{"type":"object","properties":{"riskIndicator":{"type":"integer","description":"告警的风险指标。"},"riskIndicatorDescription":{"type":"string","description":"风险指标说明。"},"detail":{"type":"array","description":"补充信息。","items":{"type":"string"}}}},"InteractionRiskData":{"type":"object","properties":{"riskIndicator":{"type":"integer","description":"告警的风险指标。"},"riskIndicatorDescription":{"type":"string","description":"风险指标说明。"},"direction":{"type":"integer","description":"交互方向。"},"hop":{"type":"integer","description":"交互跳数。"},"exposureValue":{"type":"string","description":"交互的风险敞口值。"},"exposurePercent":{"type":"string","description":"交互的风险敞口比例。"},"contributions":{"type":"array","description":"交互的贡献来源。","items":{"type":"object","properties":{"detail":{"type":"string","description":"贡献来源详情。"},"address":{"type":"string","description":"贡献来源地址。"},"label":{"type":"string","description":"地址标签（如有）。"},"hop":{"type":"integer","description":"贡献来源跳数。"},"exposureValue":{"type":"string","description":"贡献来源的风险敞口值。"},"exposurePercent":{"type":"number","description":"贡献来源的风险敞口比例。"}}}}}},"LargeTransferData":{"type":"object","properties":{"transaction":{"type":"string","description":"交易哈希。"},"usdValue":{"type":"string","description":"该转账的美元价值。"},"direction":{"type":"integer","description":"该转账的方向。"},"timestamp":{"type":"integer","description":"该转账的时间戳。"},"token":{"type":"string","description":"代币地址。"},"tokenSymbol":{"type":"string","description":"代币符号。"},"tokenAmount":{"type":"string","description":"转移的代币数量。"}}},"HighFrequencyData":{"type":"object","properties":{"transactionCount":{"type":"integer","description":"高频交易序列中的交易数量。"},"duration":{"type":"integer","description":"高频交易序列的持续时间。"},"transactionList":{"type":"array","description":"高频交易序列中的交易列表。","items":{"$ref":"#/components/schemas/TransactionItem"}}}},"TransactionItem":{"$ref":"#/components/schemas/LargeTransferData"},"TransitAddressData":{"type":"object","properties":{"inTransaction":{"type":"string","description":"交易哈希。"},"inTimestamp":{"type":"string","description":"交易时间戳。"},"inUsdValue":{"type":"string","description":"交易对应的 USD 金额。"},"outTransaction":{"type":"string","description":"交易哈希。"},"outTimestamp":{"type":"string","description":"交易时间戳。"},"outUsdValue":{"type":"string","description":"交易对应的 USD 金额。"},"transitPercent":{"type":"string","description":"该交易的过路占比。"}}},"BlacklistInteractionData":{"type":"object","properties":{"transaction":{"type":"string","description":"交易哈希。"},"usdValue":{"type":"string","description":"交易对应的 USD 金额。"},"timestamp":{"type":"string","description":"交易时间戳。"},"direction":{"type":"integer","description":"交易方向。"},"fromAddress":{"type":"string","description":"发送方地址。"},"toAddress":{"type":"string","description":"接收方地址。"},"token":{"type":"string","description":"代币地址。"},"tokenSymbol":{"type":"string","description":"代币符号。"},"tokenAmount":{"type":"string","description":"转账代币数量。"}}},"ParticipantRiskData":{"type":"object","properties":{"address":{"type":"string","description":"参与方地址。"},"riskIndicator":{"type":"integer","description":"参与方风险指标。"},"riskIndicatorDescription":{"type":"string","description":"风险指标说明。"},"detail":{"type":"array","description":"补充信息。","items":{"type":"string"}}}},"RapidTransitData":{"type":"object","properties":{"proceedTransaction":{"type":"object","description":"交易数据。","$ref":"#/components/schemas/LargeTransferData"},"screenedTransaction":{"type":"object","description":"交易数据。","$ref":"#/components/schemas/LargeTransferData"}}}}},"paths":{"/addresses/screen/tasks/{task_id}":{"get":{"tags":["地址筛查"],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string"},"description":"批量筛查 API 返回的任务 ID。"},{"name":"includeDetails","in":"query","description":"是否在告警对象中包含 riskDetail。","schema":{"type":"boolean"}}],"responses":{"200":{"description":"成功响应","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/code","description":"该请求的状态码。关于所有可能出现的 code 和 message，请查看：[https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/error-messages)。"},"msg":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/msg","description":"该请求的 message。关于所有可能出现的 code 和 message，请查看：[https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction/error-messages)。"},"data":{"$ref":"#/components/schemas/AddressScreenResult"}}}}}}},"description":"获取已提交的批量地址筛查任务结果。","summary":"获取地址筛查任务结果"}}}}
```