风险快照
查询不晚于指定时点的最新可用风险观测。
可查询数据
- 返回数据
- 查询不晚于指定时点的最新可用风险观测。
- 每次返回什么
- 每个对象和指标在截止时点前的最新可用观测
认证
需要具备 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可选风险类别筛选
metric_codestringquery示例["open_interest"]可选指标代码,最多 20 项。REST 传 JSON 数组字符串,例如 ["open_interest"];MCP 传数组
查询不晚于as_of的最新可用观测;实际观测可能早于该时点
as_ofstringquery示例2026-11-04T22:30:00Z可选RFC3339 UTC 截止时刻,默认当前 UTC。观测可能更早,请检查 resolved_as_of
对象输入模板
以下为输入形状,不代表已有数据覆盖。已覆盖的未平仓量查询可使用listing示例。
[
{
"type": "listing",
"id": "listing_gate_BTC_USDT_perp"
}
][
{
"type": "chain_contract",
"chain_id": "ethereum",
"contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]响应
本 task 的业务数据;Token Security 为对象,其他查询通过 items 返回
itemsobject[]该 task 对应的风险记录
history_endstring已覆盖历史的最后时刻
history_startstring已覆盖历史的最早时刻
latest_observation_idstring快照选中的观测记录 ID
latest_value_boolboolean | null最新布尔值或 null
latest_value_jsonunknown | null最新结构化值或 null
latest_value_numericnumber | null不晚于 as_of 的最新数值观测,须同时读取 unit
latest_value_textstring | null最新文本值或 null
metric_codestring指标代码,例如 open_interest
requested_as_ofstring请求的截止时点
resolved_as_ofstring不晚于截止时点的最新可用观测时间,可能早于请求时间
risk_typestring | null风险类别
source_task_idstring源任务 ID
target_ref_keystring | null已解析的目标引用键,不要自行用符号拼接
unitstring | null数值单位;已验证 OI 样例为 usd
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请求追踪标识