For the complete documentation index, see llms.txt. This page is also available as Markdown.

outcomeTemplatesOverview

List all registered permissionless HIP-4 outcome templates.

Returns every registered outcome template — the blueprints that permissionless venue deployers mint markets from via registerStandaloneOutcomeFromTemplate. One entry per template id, always the latest registration (templates can be re-registered with updated keyword types).

POST Request

Field
Type
Description

type

string

Must be "outcomeTemplatesOverview"

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "outcomeTemplatesOverview"}'
import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={'type': 'outcomeTemplatesOverview'},
    headers={'Authorization': f"Bearer {os.environ['HYDROMANCER_API_KEY']}"},
)
print(response.json())

Response

Field
Type
Description

templates

array

All templates, ordered by id

templates[].id

string

Template id referenced by registerStandaloneOutcomeFromTemplate, e.g. "binaryPrice"

templates[].keywordToHint

array of [string, string]

Placeholder slots and their type hints, e.g. ["perp", "hlPerp"], ["threshold", "uDecimal"], ["time", "dateTime"]

templates[].nameAndDescription

[string, string]

Market name and description text with {keyword} placeholders

templates[].role

object or string

Chain role, passed through verbatim: {"standaloneOutcome": {"sideNames": [...]}}, "question", or {"questionOutcome": {"parent": "..."}}

templates[].semanticRestriction

object, string, or null

Intended semantics of markets minted from this template, passed through verbatim. Markets contradicting it are malformed and slashable by validators. null on templates registered before the field existed

templates[].registeredAt

integer

Registration time of the latest version, ms since epoch

{
  "templates": [
    {
      "id": "binaryPrice",
      "keywordToHint": [["perp", "hlPerp"], ["threshold", "uDecimal"], ["time", "dateTime"]],
      "nameAndDescription": [
        "{perp} above {threshold} at {time}?",
        "If the {perp} mark price at time of settlement is above {threshold} at {time}, Yes tokens pay out $1 each. Otherwise, No tokens pay out $1 each."
      ],
      "role": {"standaloneOutcome": {"sideNames": ["Yes", "No"]}},
      "registeredAt": 1785912700675
    },
    {
      "id": "sportsContestParticipant",
      "keywordToHint": [["participant", "string"]],
      "nameAndDescription": [
        "{participant}",
        "This outcome resolves to Yes if {participant} is the winner under the Contest Result or administrative-decision provisions of the parent question."
      ],
      "role": {"questionOutcome": {"parent": "sportsContestResult"}},
      "registeredAt": 1785919796967
    }
  ]
}

Last updated