风险事件即将上线
查询风险事件;事件数据覆盖有限。
可查询数据
- 返回数据
- 查询风险事件;事件数据覆盖有限。
- 每次返回什么
- 每条记录对应一个已收录事件;当前示例未返回事件
认证
需要具备 Risk 权限的 API Key。
请求参数
REST传URL编码的JSON数组字符串;MCP直接传JSON数组。标识有效不代表已有数据覆盖
object_refsstringquery示例[{"type":"listing","id":"listing_gate_BTC_USDT_perp"}]必填URL 编码的 JSON 数组字符串。支持 listing、instrument、asset、asset_entity、chain_contract;链合约必须包含 chain_id 与 contract_address。MCP 直接传数组;输入有效不代表已有覆盖
risk_typestringquery可选风险类别筛选
event_typestringquery可选事件类型;REST 多值用 JSON 数组字符串,MCP 用数组
risk_tagsstringquery可选风险标签;REST 多值用 JSON 数组字符串,MCP 用数组
start与end须同时填写。as_of为观测截止时点,不等于实际返回的观测时间
startstringquery可选RFC3339 UTC 起始时刻,包含边界;必须与 end 成对传入
endstringquery可选RFC3339 UTC 结束时刻,包含边界,不早于 start;必须成对传入
as_ofstringquery可选RFC3339 UTC 截止时刻,默认当前 UTC。观测可能更早,请检查 resolved_as_of
limit为1–200;续页使用metadata.next_cursor,其他筛选条件保持不变
limitintegerquery示例5可选每页最多返回条数,范围 1–200。 · 默认: 50 · ≥ 1 · ≤ 200
cursorstringquery可选上一页的 metadata.next_cursor;续查时保持其他筛选参数不变
对象输入模板
以下为输入形状,不代表已有数据覆盖。已覆盖的未平仓量查询可使用listing示例。
[
{
"type": "listing",
"id": "listing_gate_BTC_USDT_perp"
}
][
{
"type": "chain_contract",
"chain_id": "ethereum",
"contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]响应
本 task 的业务数据;Token Security 为对象,其他查询通过 items 返回
itemsobject[]该 task 对应的风险记录
event_idstring风险事件 ID
event_subtypestring | null事件子类型,可为 null
event_typestring | null事件类型
evidence_refstring | null证据引用,可为 null
occurred_atstring | null事件发生时刻,可为 null
published_atstring | null源发布时间,可为 null
risk_tagsunknown[]事件风险标签
risk_typestring | null风险类别
source_urlstring | null源证据 URL,可为 null
summarystring | null有覆盖时返回的事件摘要
target_ref_keystring | null已解析的目标引用键,不要自行用符号拼接
missing_metricsstring[]未覆盖的请求指标
data_statusDataStatusok / partial / no_data / upstream_error / not_ready;HTTP 200 不代表数据覆盖完整
empty_reasonstring | null成功时为 null;空结果读取 not_covered 或 object_unresolved 等原因
成功时为 null;参数或上游错误为结构化对象
codestring错误代码
detailsobject错误详情
messagestring错误说明
retryableboolean是否可以重试
generated_atstring响应生成时刻,不是数据观测时刻
对象解析、分页和实际观测时点
has_moreboolean是否仍有下一页
next_cursorstring | null下一页游标,无下一页时为 null
object_refsobject[]已匹配对象引用
asset_entity_idstring | null资产实体 ID
asset_idstring | null资产标识,标识股票、加密资产等资产对象
chain_idstring | null链标识
contract_addressstring | null该链上的代币合约地址
idstring | null对象标识,标识 type 指定的具体对象
instrument_idstring | null交易工具标识,标识股票、现货交易对或合约等具体交易产品
listing_idstring | null交易场所挂牌标识,标识某个交易品种在特定交易场所的挂牌记录
quote_currencystring | null报价币种线索
symbolstring | null资产符号线索
typeObjectRefType对象类型:listing、instrument、asset、asset_entity、chain_contract
venue_idstring | null交易场所标识,标识交易所或交易平台
requested_as_ofstring | null请求的截止时点
resolved_as_ofstring | null不晚于截止时点的最新可用观测时间,可能早于请求时间
unresolved_object_refsobject[]未解析的对象引用
asset_entity_idstring | null资产实体 ID
asset_idstring | null资产标识,标识股票、加密资产等资产对象
chain_idstring | null链标识
contract_addressstring | null该链上的代币合约地址
idstring | null对象标识,标识 type 指定的具体对象
instrument_idstring | null交易工具标识,标识股票、现货交易对或合约等具体交易产品
listing_idstring | null交易场所挂牌标识,标识某个交易品种在特定交易场所的挂牌记录
quote_currencystring | null报价币种线索
symbolstring | null资产符号线索
typestring对象类型:listing、instrument、asset、asset_entity、chain_contract
venue_idstring | null交易场所标识,标识交易所或交易平台
request_idstring请求追踪标识