Risk eventsComing soon
Query risk events; event-data coverage is limited.
Available data
- Returns
- Query risk events; event-data coverage is limited.
- What each request returns
- One covered event per record; the saved example contains no events
Authentication
Requires an API key with Risk permission.
Query Parameters
REST uses a URL-encoded JSON array; MCP uses a JSON array directly. Valid identifiers do not guarantee data coverage
object_refsstringqueryExample[{"type":"listing","id":"listing_gate_BTC_USDT_perp"}]requiredURL-encoded JSON array of listing, instrument, asset, asset_entity or chain_contract references. MCP takes an array directly. chain_contract requires chain_id and contract_address; a valid reference does not guarantee coverage
risk_typestringqueryoptionalFilter by risk category
event_typestringqueryoptionalEvent type filters; JSON array string in REST, array in MCP
risk_tagsstringqueryoptionalRisk tag filters; JSON array string in REST, array in MCP
start and end must be supplied together. as_of is the observation cutoff, not the returned observation time
startstringqueryoptionalInclusive RFC3339 UTC start time. Supply start and end together
endstringqueryoptionalInclusive RFC3339 UTC end time, not earlier than start. Supply both bounds together
as_ofstringqueryoptionalRFC3339 UTC cutoff, default current UTC time. Returned observations may be older; check resolved_as_of
limit is 1–200. Reuse metadata.next_cursor without changing other filters
limitintegerqueryExample5optionalMaximum rows returned. · Default: 50 · ≥ 1 · ≤ 200
cursorstringqueryoptionalOpaque metadata.next_cursor from the previous response. Keep the other filters unchanged
Object input templates
These are input shapes, not proof of coverage. Use the verified listing example for covered open-interest observations.
[
{
"type": "listing",
"id": "listing_gate_BTC_USDT_perp"
}
][
{
"type": "chain_contract",
"chain_id": "ethereum",
"contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]Response
Business data; shape is specific to this endpoint
itemsobject[]Task-specific risk rows
event_idstringRisk event identifier
event_subtypestring | nullEvent subtype, or null
event_typestring | nullEvent type
evidence_refstring | nullEvidence reference, or null
occurred_atstring | nullEvent occurrence time, or null
published_atstring | nullSource publication time, or null
risk_tagsunknown[]Event risk tags
risk_typestring | nullRisk category
source_urlstring | nullSource evidence URL, or null
summarystring | nullEvent summary, when covered
target_ref_keystring | nullResolved target identifier; use returned values rather than constructing it from symbols
missing_metricsstring[]Requested metric codes that are not covered
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
empty_reasonstring | nullReason for an empty or unavailable result; may be absent
Null on success; otherwise an error string or object
codestringError code
detailsobjectAdditional error details
messagestringError explanation
retryablebooleanWhether the error can be retried
generated_atstringResponse generation time, not the observation time
Response metadata
has_morebooleanWhether a subsequent page is available
next_cursorstring | nullOpaque cursor; null when no next page is available
object_refsobject[]Matched object references
asset_entity_idstring | nullAsset entity identifier
asset_idstring | nullCanonical asset identifier
chain_idstring | nullCanonical chain identifier
contract_addressstring | nullToken contract address associated with chain_id
idstring | nullCanonical object identifier
instrument_idstring | nullInstrument identifier
listing_idstring | nullListing identifier
quote_currencystring | nullQuote currency hint
symbolstring | nullAsset or pool token symbol
typeObjectRefTypeReference type: listing, instrument, asset, asset_entity or chain_contract
venue_idstring | nullVenue identifier
requested_as_ofstring | nullRequested cutoff time
resolved_as_ofstring | nullLatest available observation at or before the cutoff; can be older than the request
unresolved_object_refsobject[]References that could not be resolved
asset_entity_idstring | nullAsset entity identifier
asset_idstring | nullCanonical asset identifier
chain_idstring | nullCanonical chain identifier
contract_addressstring | nullToken contract address associated with chain_id
idstring | nullCanonical object identifier
instrument_idstring | nullInstrument identifier
listing_idstring | nullListing identifier
quote_currencystring | nullQuote currency hint
symbolstring | nullAsset or pool token symbol
typestringReference type: listing, instrument, asset, asset_entity or chain_contract
venue_idstring | nullVenue identifier
request_idstringRequest trace identifier