Risk eventsComing soon

Query risk events; event-data coverage is limited.

This endpoint is coming soon. Documentation is available for preview. REST and MCP execution remain disabled until the endpoint is released.
GET/api/v1/risk/events
Domain
Risk & Compliance
Level
One covered event per record; the saved example contains no events
MCP tool
risk_compliance_query (task=events)

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

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Requires an API key with Risk permission.

Query Parameters

Query objects

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"}]required

URL-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

Event filters
risk_typestringqueryoptional

Filter by risk category

event_typestringqueryoptional

Event type filters; JSON array string in REST, array in MCP

risk_tagsstringqueryoptional

Risk tag filters; JSON array string in REST, array in MCP

Time range

start and end must be supplied together. as_of is the observation cutoff, not the returned observation time

startstringqueryoptional

Inclusive RFC3339 UTC start time. Supply start and end together

endstringqueryoptional

Inclusive RFC3339 UTC end time, not earlier than start. Supply both bounds together

as_ofstringqueryoptional

RFC3339 UTC cutoff, default current UTC time. Returned observations may be older; check resolved_as_of

Filters and pagination

limit is 1–200. Reuse metadata.next_cursor without changing other filters

limitintegerqueryExample5optional

Maximum rows returned. · Default: 50 · ≥ 1 · ≤ 200

cursorstringqueryoptional

Opaque 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.

Identifier object
JSON
[
  {
    "type": "listing",
    "id": "listing_gate_BTC_USDT_perp"
  }
]
Chain contract object
JSON
[
  {
    "type": "chain_contract",
    "chain_id": "ethereum",
    "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  }
]

Response

dataobject | null

Business data; shape is specific to this endpoint

itemsobject[]

Task-specific risk rows

items[]array[object]
event_idstring

Risk event identifier

event_subtypestring | null

Event subtype, or null

event_typestring | null

Event type

evidence_refstring | null

Evidence reference, or null

occurred_atstring | null

Event occurrence time, or null

published_atstring | null

Source publication time, or null

risk_tagsunknown[]

Event risk tags

risk_typestring | null

Risk category

source_urlstring | null

Source evidence URL, or null

summarystring | null

Event summary, when covered

target_ref_keystring | null

Resolved target identifier; use returned values rather than constructing it from symbols

missing_metricsstring[]

Requested metric codes that are not covered

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

empty_reasonstring | null

Reason for an empty or unavailable result; may be absent

errorobject | null

Null on success; otherwise an error string or object

codestring

Error code

detailsobject

Additional error details

messagestring

Error explanation

retryableboolean

Whether the error can be retried

generated_atstring

Response generation time, not the observation time

metadataobject

Response metadata

has_moreboolean

Whether a subsequent page is available

next_cursorstring | null

Opaque cursor; null when no next page is available

object_refsobject[]

Matched object references

object_refs[]array[object]
asset_entity_idstring | null

Asset entity identifier

asset_idstring | null

Canonical asset identifier

chain_idstring | null

Canonical chain identifier

contract_addressstring | null

Token contract address associated with chain_id

idstring | null

Canonical object identifier

instrument_idstring | null

Instrument identifier

listing_idstring | null

Listing identifier

quote_currencystring | null

Quote currency hint

symbolstring | null

Asset or pool token symbol

Reference type: listing, instrument, asset, asset_entity or chain_contract

venue_idstring | null

Venue identifier

requested_as_ofstring | null

Requested cutoff time

resolved_as_ofstring | null

Latest available observation at or before the cutoff; can be older than the request

unresolved_object_refsobject[]

References that could not be resolved

unresolved_object_refs[]array[object]
asset_entity_idstring | null

Asset entity identifier

asset_idstring | null

Canonical asset identifier

chain_idstring | null

Canonical chain identifier

contract_addressstring | null

Token contract address associated with chain_id

idstring | null

Canonical object identifier

instrument_idstring | null

Instrument identifier

listing_idstring | null

Listing identifier

quote_currencystring | null

Quote currency hint

symbolstring | null

Asset or pool token symbol

typestring

Reference type: listing, instrument, asset, asset_entity or chain_contract

venue_idstring | null

Venue identifier

request_idstring

Request trace identifier

Errors & fallback

200
The requested data is returned.
200
Partial coverage; inspect data.missing_metrics for missing metrics and the returned fields.
200
Object resolved, but data is not covered; this does not establish absence of risk.
200
Object unresolved; check IDs and metadata.unresolved_object_refs.
400
Invalid parameters, time-bound pairing or range; limit must be 1–200.
401
Check the API key.
403
Check Risk permission for the key.