{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "ApiResponseWebhookEventTypeArray",
"description": "API response containing the served webhook event catalog.",
"type": "object",
"required": [
"data",
"meta",
"success"
],
"properties": {
"data": {
"type": "array",
"items": {
"description": "One entry in the served webhook event catalog. Subscriptions are validated against this declaration, so it is the authority on the filters, parameters and metrics an event type accepts.",
"type": "object",
"required": [
"cost_floor",
"description",
"filters",
"filters_example",
"latency_class",
"live",
"metrics",
"operators",
"params",
"schema_version",
"scope",
"type",
"venues"
],
"properties": {
"cost_floor": {
"description": "The smallest occurrence this type reports at all, below which nothing is detected. Null when the type has no floor.",
"type": "object",
"nullable": true,
"required": [
"metric",
"min"
],
"properties": {
"metric": {
"description": "Metric the floor applies to.",
"type": "string",
"example": "notional_usd"
},
"min": {
"description": "Lowest value still reported.",
"type": "number",
"example": 100
},
"note": {
"description": "How the floor applies, when it needs saying.",
"type": "string"
},
"unit": {
"description": "Unit of `min` when it is not the metric's own unit.",
"type": "string",
"example": "HYPE"
}
}
},
"description": {
"description": "What the event reports and what one occurrence means.",
"type": "string",
"example": "A liquidation on a covered venue."
},
"filters": {
"description": "Filter keys the subscription config accepts for this type. A key that is not listed here is refused rather than ignored.",
"type": "array",
"items": {
"type": "string"
},
"example": [
"venue",
"symbols"
]
},
"filters_example": {
"description": "A worked example of a config for this type.",
"type": "object",
"additionalProperties": true
},
"latency_class": {
"description": "Rough delivery latency for the type, measured from the occurrence to the first delivery attempt.",
"type": "string",
"enum": [
"seconds",
"minutes"
],
"example": "seconds"
},
"live": {
"description": "True when the type accepts subscriptions. A type that is published but not yet live is refused at create time.",
"type": "boolean",
"example": true
},
"metrics": {
"description": "Metrics carried by the event, keyed by metric name. A condition may only reference a metric declared here.",
"type": "object",
"additionalProperties": {
"description": "A metric an event carries, and therefore a metric a subscription condition may be written against.",
"type": "object",
"properties": {
"description": {
"description": "What the metric measures, including when it is null.",
"type": "string"
},
"type": {
"description": "Value type of the metric. It decides which operators a condition on this metric may use. An `enum` metric lists its accepted values in `values`.",
"type": "string",
"enum": [
"number",
"integer",
"string",
"boolean",
"timestamp",
"enum"
],
"example": "number"
},
"unit": {
"description": "Unit the metric is expressed in, when it has one.",
"type": "string",
"example": "USD"
},
"values": {
"description": "Accepted values of an `enum` metric. Conditions are checked against this list.",
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"operators": {
"description": "Operator vocabulary, grouped: `number` (metric types `number` and `integer`), `text` (`string` and `enum`), `boolean`, `timestamp`, and `any`, which applies to every metric. A condition on a metric may use the operators of its group or of `any`.",
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"params": {
"description": "Tunable parameters, keyed by parameter name.",
"type": "object",
"additionalProperties": {
"description": "A tunable parameter declared by an event type. Values sent under `params` are validated against this declaration, and any declared parameter left unset is stored at its default.",
"type": "object",
"properties": {
"default": {
"description": "Value used when the parameter is not supplied.",
"example": 3600
},
"description": {
"description": "What the parameter changes.",
"type": "string"
},
"enum": {
"description": "Accepted values, when the parameter is a fixed choice.",
"type": "array",
"items": {}
},
"max": {
"description": "Highest accepted value, when the parameter is bounded above.",
"type": "number",
"example": 86400
},
"min": {
"description": "Lowest accepted value, when the parameter is bounded below.",
"type": "number",
"example": 60
},
"type": {
"description": "Value type the parameter accepts.",
"type": "string",
"enum": [
"integer",
"number",
"string",
"array_of_number"
],
"example": "integer"
},
"unit": {
"description": "Unit the value is expressed in, when it has one.",
"type": "string",
"example": "s"
}
}
}
},
"schema_version": {
"description": "Version of the delivered payload shape for this event type.",
"type": "integer",
"example": 1
},
"scope": {
"description": "Who the event is about. `public` is market wide, `user` is your own account and platform activity, and `addresses` reports only on wallets on your watched list.",
"type": "string",
"enum": [
"public",
"user",
"addresses"
],
"example": "public"
},
"type": {
"description": "Event type identifier. Send this as `event_type` when creating a subscription.",
"type": "string",
"example": "market.liquidation"
},
"venues": {
"description": "Venues the type covers. Empty when the type is not venue scoped.",
"type": "array",
"items": {
"type": "string"
},
"example": [
"hyperliquid",
"hip3",
"lighter"
]
}
}
}
},
"meta": {
"description": "Response metadata. Every 2xx JSON response carries `meta.request_id`; list payloads add `count`; cursor-paged routes add `has_more` and, when another page follows, `next_cursor`; per-symbol routes add `symbol` and `venue`. Fields that do not apply to a route are omitted.",
"type": "object",
"required": [
"request_id"
],
"properties": {
"as_of": {
"description": "Positioning: the 5-minute close the records describe, equal to each record's `window_end`.",
"type": "string",
"format": "date-time"
},
"built_through": {
"description": "Trade intent: how far the series is built. A second without a record had no trades up to this instant; after it nothing is known yet.",
"type": "string",
"format": "date-time"
},
"clamped_to": {
"description": "The boundary the request's `end` was clamped to, when clamping occurred.",
"type": "string",
"format": "date-time",
"nullable": true
},
"count": {
"description": "Number of records returned",
"type": "integer"
},
"coverage_from": {
"description": "Earliest coverage for the requested symbol and data type. Present only when the requested window ends before coverage begins.",
"type": "string",
"format": "date-time"
},
"finalized_through": {
"description": "Two-tier datasets (Lighter trades): data at or before this instant is final; later data is preliminary.",
"type": "string",
"format": "date-time"
},
"has_more": {
"description": "Cursor-paged routes: whether another page follows. `next_cursor` is present exactly when this is `true`. A final page can be empty when the previous page was exactly full; `has_more` is `false` on it.",
"type": "boolean"
},
"next_cursor": {
"description": "Opaque cursor for the next page, present exactly when `has_more` is `true`. Pass it back unchanged as `cursor` with the same filters. Do not parse or construct it.",
"type": "string"
},
"notice": {
"description": "Human-readable advisory about the response. Used when the requested window ends before coverage begins for the symbol, and on CVD responses that are one page of several; may carry other advisories in future.",
"type": "string"
},
"preliminary_row_count": {
"description": "Number of preliminary rows in this response, on routes that intentionally serve preliminary data (Lighter `/recent`, trade intent).",
"type": "integer",
"nullable": true
},
"request_id": {
"description": "Unique request ID for support",
"type": "string",
"format": "uuid"
},
"requested_end": {
"description": "The `end` the request asked for, echoed when it was clamped to `finalized_through`.",
"type": "string",
"format": "date-time",
"nullable": true
},
"symbol": {
"description": "Per-symbol routes: the canonical public symbol the response describes (for example `BTC`, `xyz:TSLA`, `HYPE-USDC`, `#0`).",
"type": "string",
"example": "BTC"
},
"venue": {
"description": "Per-symbol routes: the venue the response describes.",
"type": "string",
"enum": [
"hyperliquid",
"hip3",
"hip4",
"spot",
"lighter",
"rh-lighter"
],
"example": "hyperliquid"
}
}
},
"success": {
"type": "boolean",
"example": true
}
}
}