> For the complete documentation index, see [llms.txt](https://docs.hydromancer.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hydromancer.xyz/readme/rest-api/outcomes/registeredoutcomes.md). # registeredOutcomes Get recent registered prediction market outcomes. Returns a list of recently registered prediction market outcomes that have not yet been settled, ordered by most recent first. ## POST Request
FieldTypeDescription
typestringMust be "registeredOutcomes"
limitintegerMax results to return, default 100, max 100 (optional)
cursorstringTake the cursor from the previous response to fetch the next page. Omit (or send null) for the first page. Must be a string — a number is a 400 — see Pagination (optional)
kindstring"all" (default), "price", or "canonical" — see The kind filter (optional)
namestringFilter by outcome name (optional)
classstringFilter by outcome class, e.g. "priceBinary" (optional)
underlyingstringFilter by underlying asset, e.g. "HYPE" (optional)
periodstringFilter by period, e.g. "15m" (optional)
categorystringFilter by canonical-market category, case-insensitive (optional)
subCategorystringFilter by canonical-market sub-category, case-insensitive (optional)
searchstringFree-text search across name, description, category and subCategory — see Free-text search (optional)
venuestringOnly outcomes deployed by this permissionless venue, e.g. "skew". 2–4 ASCII letters, case-insensitive (optional)
deployedBystring"all" (default), "validator" (registered by validator quorum, no venue), or "venue" (any permissionless venue) (optional)
> By default (`kind` omitted) all outcome kinds are returned. Pass `kind: "price"` for structured price markets only, or `kind: "canonical"` for HIP-4 prose markets only. See [The kind filter](#the-kind-filter). {% tabs %} {% tab title="cURL" %} ```bash curl -X POST https://api.hydromancer.xyz/info \ -H "Authorization: Bearer $HYDROMANCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "registeredOutcomes", "limit": 10, "underlying": "HYPE" }' ``` {% endtab %} {% tab title="Python" %} ```python import requests import os response = requests.post( 'https://api.hydromancer.xyz/info', json={ 'type': 'registeredOutcomes', 'limit': 10, 'underlying': 'HYPE' }, headers={ 'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}', 'Content-Type': 'application/json' } ) print(response.json()) ``` {% endtab %} {% tab title="Javascript" %} ```javascript import axios from 'axios'; try { const response = await axios.post('https://api.hydromancer.xyz/info', { type: 'registeredOutcomes', limit: 10, underlying: 'HYPE' }, { headers: { 'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`, 'Content-Type': 'application/json' } }); console.log(response.data); } catch (error) { console.error('Error:', error.message); } ``` {% endtab %} {% endtabs %} Only outcomes deployed by the `skew` venue, then only validator-deployed outcomes: ```bash curl -X POST https://api.hydromancer.xyz/info \ -H "Authorization: Bearer $HYDROMANCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "registeredOutcomes", "kind": "all", "venue": "skew"}' curl -X POST https://api.hydromancer.xyz/info \ -H "Authorization: Bearer $HYDROMANCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "registeredOutcomes", "kind": "all", "deployedBy": "validator"}' ``` *** ## Response Fields Returns an object with two arrays — `outcomes` (the registered outcome objects, sorted descending by `outcomeId`) and `questions` (the parent HIP-4 questions of any priceBucket children that appear in `outcomes`, sorted descending by `questionId`) — plus the two pagination fields below. Both arrays are always present, even when empty. | Field | Type | Description | | ----------- | ------- | ------------------------------------------------------------- | | `outcomes` | array | The registered outcome objects on this page | | `questions` | array | Parent questions of the outcomes on this page | | `hasMore` | boolean | `true` when another page follows | | `cursor` | string | Pass to the next request to continue. Absent on the last page | The `limit`, `cursor` and the filter parameters (`name`, `class`, `underlying`, `period`, `search`) apply to `outcomes` only. `questions` is derived from the resulting outcomes — a question is included if at least one of its children (named or fallback) is in the `outcomes` result. `hasMore` and `cursor` likewise describe `outcomes` only; `questions` is not paginated. Practical implications: filtering by `class: "priceBinary"` yields priceBinary outcomes plus an empty `questions` array (standalone outcomes have no parent question); filtering by `class: "priceBucket"` yields priceBucket children plus their parent question(s). ### Pagination Walk the full result set by holding `limit` and the filters fixed and passing back the `cursor` from each response until it is absent: ```bash curl -X POST https://api.hydromancer.xyz/info \ -H "Authorization: Bearer $HYDROMANCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "registeredOutcomes", "limit": 100}' curl -X POST https://api.hydromancer.xyz/info \ -H "Authorization: Bearer $HYDROMANCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "registeredOutcomes", "limit": 100, "cursor": "3170"}' ``` ```python cursor, everything = None, [] while True: body = {"type": "registeredOutcomes", "limit": 100} if cursor: body["cursor"] = cursor page = post(body) everything += page["outcomes"] cursor = page.get("cursor") if not cursor: break ``` Send the cursor back exactly as you received it, as a string. A numeric `cursor` returns a `400`. The cursor is exclusive, so no outcome appears on two pages. The list is live, though: an outcome that settles before you reach it drops off this endpoint and will not appear on a later page. Look for it in [settledOutcomes](/readme/rest-api/outcomes/settledoutcomes.md). Keep the filters identical across a walk. Changing one invalidates the cursor. ### Outcome object | Field | Type | Description | | ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `outcomeId` | integer | The outcome ID | | `kind` | string | `"price"` for structured markets, `"canonical"` for HIP-4 validator-voted (prose) markets | | `name` | string | Outcome name from the register event | | `description` | string | Pipe-separated description (\`class:... | | `sideSpecs` | array | Side specifications, e.g. `[{"name":"Yes"},{"name":"No"}]` | | `class` | string? | `"priceBinary"` or `"priceBucket"`. `null` when `kind` is `"canonical"` | | `underlying` | string? | Underlying asset, e.g. `"HYPE"`. `null` when `kind` is `"canonical"` | | `expiry` | string? | Expiry timestamp, e.g. `"20260508-1300"`. `null` when `kind` is `"canonical"` | | `targetPrice` | string? | Numeric strike for `priceBinary`; bucket-range string for `priceBucket` (see [Target price formats](#target-price-formats) below). `null` when `kind` is `"canonical"` | | `period` | string? | Period, e.g. `"15m"`. `null` when `kind` is `"canonical"` | | `category` | string? | Canonical-market category. `null` on price markets | | `subCategory` | string? | Canonical-market sub-category. `null` on price markets | | `quoteToken` | string | Quote token ID | | `yesAssetId` | string | YES-side asset ID, format `"#{outcomeId * 10}"` | | `noAssetId` | string | NO-side asset ID, format `"#{outcomeId * 10 + 1}"` | | `yesStats` | object | Market stats for the YES side. Always present; zero-valued when no fills (see [Stats object](#stats-object) below) | | `noStats` | object | Market stats for the NO side | | `deployerAddress` | string? | Permissionless-venue deployer address; null on validator-registered outcomes | | `deployerVenue` | string? | Permissionless venue name (see `outcomeMeta.deployers`); null on validator-registered outcomes | | `templateId` | string? | Template the outcome was deployed from, e.g. `"binaryPrice"` (see [outcomeTemplatesOverview](/readme/rest-api/outcomes/outcometemplatesoverview.md)); null on outcomes not created from a template | | `deployerFeeScale` | string? | Multiplier applied to the deployer fee for this market, e.g. `"10"`. `null` on validator-registered outcomes and when the chain uses its default scale of 1 | | `registeredAt` | object | Chain position of the event that registered the outcome (see [registeredAt object](#registeredat-object) below). A later description change does not move it. Always present and complete: an outcome whose register event is not known is not returned | ### registeredAt object Uses the same field names and values as the `register` event for this outcome on [hip4MarketEvents](/readme/websocket/hip4marketevents.md). | Field | Type | Description | | ------------- | ------- | -------------------------------------------------------------------------------- | | `time` | integer | Block timestamp (ms) | | `blockNumber` | integer | Block height | | `txIndex` | integer | Position within the block. Outcomes registered together with a question share it | ### Question object Question entries appear when the response includes priceBucket children — each such child has a parent question grouping 3 named children plus one fallback child. Question fields: | Field | Type | Description | | ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `questionId` | integer | The question ID (assigned by chain) | | `kind` | string | `"price"` or `"canonical"` | | `name` | string | Question name | | `description` | string | Pipe-separated description; named children copy this as-is | | `class` | string? | `"priceBucket"`. `null` when `kind` is `"canonical"` | | `underlying` | string? | Underlying asset. `null` when `kind` is `"canonical"` | | `expiry` | string? | Expiry timestamp. `null` when `kind` is `"canonical"` | | `period` | string? | Period. `null` when `kind` is `"canonical"` | | `priceThresholds` | string? | Sorted comma-separated list of 2 cut-points. `null` when `kind` is `"canonical"` | | `category` | string? | Canonical-market category. `null` on price questions | | `subCategory` | string? | Canonical-market sub-category. `null` on price questions | | `quoteToken` | string | Quote token ID | | `fallbackOutcome` | integer | `outcomeId` of the fallback child | | `fallbackName` | string | Name of the fallback child | | `fallbackDescription` | string | Description of the fallback child | | `namedOutcomes` | array of integers | `outcomeId`s of the named children still open, in named-index order. A child that settles moves to `settledNamedOutcomes` | | `settledNamedOutcomes` | array of integers | `outcomeId`s of named children already settled. Disjoint from `namedOutcomes`, matching `outcomeMeta`. A question can have settled children while it is still open | | `stats` | object | Aggregate trading stats across the question's children. Always present; zero-valued when no fills. See [Stats object](#stats-object) below. | | `deployerAddress` | string? | Permissionless-venue deployer address; null on validator-registered questions | | `deployerVenue` | string? | Permissionless venue name; null on validator-registered questions | | `templateId` | string? | Template the question was deployed from, e.g. `"sportsContestResult"` (see [outcomeTemplatesOverview](/readme/rest-api/outcomes/outcometemplatesoverview.md)); null on questions not created from a template | | `deployerFeeScale` | string? | Multiplier applied to the deployer fee, e.g. `"10"`. `null` on validator-registered questions and when the chain uses its default scale of 1 | ### Stats object All stats fields reflect orderbook trading. The object is always emitted — when there are no fills, every numeric field is zero and timestamps are `0`. | Field | Type | Description | | ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `coin` | string | Asset ID for this side | | `trades` | integer | Number of fills | | `uniqueTraders` | integer | Distinct users that traded this side | | `volumeNotional` | string | Sum of `px * sz` across fills | | `volumeContracts` | string | Sum of `sz` across fills | | `lastPrice` | string | Price of the most recent fill | | `vwap` | number | Volume-weighted average price | | `minPrice` | string | Minimum fill price | | `maxPrice` | string | Maximum fill price | | `avgTradeNotional` | number | Mean `px * sz` | | `medianTradeNotional` | number | Median `px * sz` | | `largestTrade` | string | Maximum `px * sz` of any fill | | `firstTrade` | integer | Timestamp (ms) of earliest fill | | `lastTrade` | integer | Timestamp (ms) of latest fill | | `volumeNotional24h` | string? | USDC traded over the last 24 hours | | `volumeContracts24h` | string? | Shares traded over the last 24 hours | | `openInterestContracts` | string? | Outstanding shares | | `openInterestNotional` | string? | USDC value of the outstanding shares at the mid price, or at the last trade price while the book is empty. `null` when no price is available | The 24-hour window starts on the minute. Each match counts on both sides of the outcome — the traded side at `px`, the other at `1 − px` — so both sides report the same `volumeContracts24h`, and their `volumeNotional24h` sum to it. `volumeNotional` and `volumeContracts` count the traded side only, so a side's 24-hour figures can exceed its all-time ones. #### Question stats object Question stats are intentionally trimmed compared to outcome stats. Price-shaped metrics (`lastPrice`, `vwap`, `minPrice`, `maxPrice`, `largestTrade`, `avgTradeNotional`, `medianTradeNotional`) don't aggregate cleanly across the children's YES + NO assets, so they aren't reported. There's no `coin` field — questions don't own a single asset. Settlement and the four HIP-4 conversion ops (`Split Outcome`, `Negate Outcome`, `Merge Outcome`, `Merge Question`) are excluded from all metrics. `volumeContracts24h` and `openInterestContracts` are reported per side only: shares of different outcomes, and of YES and NO, are different tokens, so a sum across children has no clear meaning. | Field | Type | Description | | ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `trades` | integer | Number of orderbook matches across all child YES + NO assets. Counts each chain match exactly once (filters to `dir = 'Buy'`; every match emits one Buy + one Sell). | | `uniqueTraders` | integer | Distinct users that traded any child asset (Buy or Sell). | | `volumeNotional` | string | Sum of `px * sz` across `dir = 'Buy'` fills on any child. | | `volumeContracts` | string | Sum of `sz` across `dir = 'Buy'` fills on any child. | | `firstTrade` | integer | Timestamp (ms) of the earliest orderbook fill on any child. | | `lastTrade` | integer | Timestamp (ms) of the latest orderbook fill on any child. | | `volumeNotional24h` | string? | USDC traded over the last 24 hours across every child, including children settled in that window. Each trade counts once at the price it traded at, so this is less than the sum of the children's `volumeNotional24h`, which also count each trade on the other side at `1 − px`. | | `openInterestNotional` | string? | USDC value of the outstanding shares across every child, valued as in the outcome's `openInterestNotional`. Children without a price count as zero; `null` only when none of the children holding shares has a price | ### Target price formats The `targetPrice` field on each outcome is a string whose format depends on the outcome's `class`. **`priceBinary`** — a single numeric strike. The outcome resolves YES if the underlying's settle price meets the strike, NO otherwise. ``` "targetPrice": "52.328" ``` **`priceBucket`** — outcomes belong to a parent question that defines `priceThresholds` (a sorted comma-separated list of 2 cut-points splitting the price line into 3 buckets). The question has 3 named children plus one fallback child. Each named child resolves YES if the settle price falls in its bucket; the fallback child resolves YES if all named children resolve NO. The format mirrors interval notation: | Child role | `targetPrice` value | Example (thresholds `80828, 81071`) | | ------------------------------ | ------------------- | ----------------------------------- | | First named child (index `0`) | `=t1` | `>=81071` | | Fallback child | raw threshold list | `80828,81071` | The fallback's literal comma-separated value signals "any price not covered by a named child" rather than a specific range. Use the parent question's `priceThresholds` field if you need to render the fallback's range yourself.
Response The example covers a priceBucket child (`outcomeId: 7609`), the corresponding fallback child (`7606`), a standalone priceBinary outcome (`7605`), and a child of a different question (`7470`) — plus both parent questions. Question `275` shows non-zero stats (16 fills); question `303` shows the zero-state. ```json { "outcomes": [ { "outcomeId": 7609, "registeredAt": {"time": 1778244300412, "blockNumber": 598113207, "txIndex": 3}, "name": "Recurring Named Outcome", "description": "class:priceBucket|underlying:BTC|expiry:20260508-1300|priceThresholds:80425,80666|period:15m", "sideSpecs": [{"name": "Yes"}, {"name": "No"}], "class": "priceBucket", "underlying": "BTC", "expiry": "20260508-1300", "targetPrice": ">=80666", "period": "15m", "quoteToken": "1452", "yesAssetId": "#76090", "noAssetId": "#76091", "yesStats": { "coin": "#76090", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" }, "noStats": { "coin": "#76091", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" } }, { "outcomeId": 7606, "registeredAt": {"time": 1778244300412, "blockNumber": 598113207, "txIndex": 3}, "name": "Recurring Fallback", "description": "class:priceBucket|underlying:BTC|expiry:20260508-1300|priceThresholds:80425,80666|period:15m", "sideSpecs": [{"name": "Yes"}, {"name": "No"}], "class": "priceBucket", "underlying": "BTC", "expiry": "20260508-1300", "targetPrice": "80425,80666", "period": "15m", "quoteToken": "1452", "yesAssetId": "#76060", "noAssetId": "#76061", "yesStats": { "coin": "#76060", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" }, "noStats": { "coin": "#76061", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" } }, { "outcomeId": 7605, "registeredAt": {"time": 1778244300412, "blockNumber": 598113207, "txIndex": 1}, "name": "Recurring", "description": "class:priceBinary|underlying:HYPE|expiry:20260508-1300|targetPrice:28.52|period:15m", "sideSpecs": [{"name": "Yes"}, {"name": "No"}], "class": "priceBinary", "underlying": "HYPE", "expiry": "20260508-1300", "targetPrice": "28.52", "period": "15m", "quoteToken": "1452", "yesAssetId": "#76050", "noAssetId": "#76051", "yesStats": { "coin": "#76050", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" }, "noStats": { "coin": "#76051", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" } }, { "outcomeId": 7470, "registeredAt": {"time": 1778240700388, "blockNumber": 598062951, "txIndex": 2}, "name": "Recurring Named Outcome", "description": "class:priceBucket|underlying:BTC|expiry:20260509-0600|priceThresholds:78342,81539|period:1d", "sideSpecs": [{"name": "Yes"}, {"name": "No"}], "class": "priceBucket", "underlying": "BTC", "expiry": "20260509-0600", "targetPrice": ">=81539", "period": "1d", "quoteToken": "1452", "yesAssetId": "#74700", "noAssetId": "#74701", "yesStats": { "coin": "#74700", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" }, "noStats": { "coin": "#74701", "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0", "vwap": 0.0, "minPrice": "0", "maxPrice": "0", "avgTradeNotional": 0.0, "medianTradeNotional": 0.0, "largestTrade": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "volumeContracts24h": "0.00", "openInterestContracts": "0.00", "openInterestNotional": "0.00" } } ], "questions": [ { "questionId": 303, "name": "Recurring", "description": "class:priceBucket|underlying:BTC|expiry:20260508-1300|priceThresholds:80425,80666|period:15m", "class": "priceBucket", "underlying": "BTC", "expiry": "20260508-1300", "period": "15m", "priceThresholds": "80425,80666", "quoteToken": "1452", "fallbackOutcome": 7606, "fallbackName": "Recurring Fallback", "fallbackDescription": "other", "namedOutcomes": [7607, 7608, 7609], "settledNamedOutcomes": [], "stats": { "trades": 0, "uniqueTraders": 0, "volumeNotional": "0", "volumeContracts": "0", "firstTrade": 0, "lastTrade": 0, "volumeNotional24h": "0.00", "openInterestNotional": "0.00" } }, { "questionId": 275, "name": "Recurring", "description": "class:priceBucket|underlying:BTC|expiry:20260509-0600|priceThresholds:78342,81539|period:1d", "class": "priceBucket", "underlying": "BTC", "expiry": "20260509-0600", "period": "1d", "priceThresholds": "78342,81539", "quoteToken": "1452", "fallbackOutcome": 7467, "fallbackName": "Recurring Fallback", "fallbackDescription": "other", "namedOutcomes": [7468, 7469, 7470], "settledNamedOutcomes": [], "stats": { "trades": 16, "uniqueTraders": 2, "volumeNotional": "7799.98", "volumeContracts": "14000.00", "firstTrade": 1778222714885, "lastTrade": 1778223020033, "volumeNotional24h": "0.00", "openInterestNotional": "0.00" } } ] } ```
*** ## Free-text search The optional `search` field matches case-insensitively against `name`, `description`, `category` and `subCategory`, combining with every other filter. A row matches when the whole query appears as a substring of one of those fields, or when every word of the query matches some word of a field: * exactly, or * as a prefix (for query words of at least 4 characters), or * within a spelling-error budget (Damerau-Levenshtein distance): words of 5–8 characters allow 1 error, 9 or more allow 2. Words of up to 4 characters get no error budget — tickers and venue codes like `BTC` never near-match. Examples: `"world cup"` matches `World Cup Final: Spain vs Argentina`; so do `"wolrd cup"` (typo) and `"spain argent"` (partial words, any order). `"BTX"` does not match `BTC`. Result order and `limit` semantics are unchanged. ## The kind filter A single optional `kind` request field selects which markets are returned: | `kind` | Returns | | ----------------- | ---------------------------------------------------- | | `"all"` (default) | Both kinds in one `outcomes` / `questions` envelope. | | `"price"` | Structured price markets only. | | `"canonical"` | HIP-4 validator-voted (prose) markets only. | The response shape is identical regardless of `kind`; each row carries a `kind` field telling you which it is. **Nullability by kind.** On a `kind: "price"` response the structured fields (`class`, `underlying`, `expiry`, `targetPrice`, `period`) are always populated and `category` / `subCategory` are `null`. On a `kind: "canonical"` response those structured fields are `null` and `category` / `subCategory` are populated. A `kind: "all"` response mixes both, so treat every structured field as nullable and branch on `kind`.