outcomeVenuesOverview

List permissionless HIP-4 venues, their lifecycle, and sub-deployer permissions.

Returns every permissionless outcome venue with its activation lifecycle and currently effective sub-deployer permissions. Only executed actions are included — failed venue claims and failed grants never appear.

POST Request

Field	Type	Description
type	string	Must be "outcomeVenuesOverview"
isActive	boolean (optional)	Only active (true) or only deactivated (false) venues; absent returns both
limit	integer (optional)	Max venues returned, in venueName order. Default 20, maximum 100

cURL

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

Python

import requests
import os

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

Response

Field	Type	Description
venues	array	All venues, ordered by venueName
venues[].venueName	string	Venue name claimed via activateOutcomeDeployer (2–4 lowercase ASCII letters)
venues[].deployer	string	Deployer address that owns the venue
venues[].activatedAt	integer or null	Latest successful activation, ms since epoch; null only if no activation was ever recorded for the venue
venues[].deactivatedAt	integer or null	Latest deactivation, ms since epoch; null if never deactivated
venues[].isActive	boolean	false once a deactivation is more recent than the latest activation
venues[].subDeployers	array	Addresses holding currently effective permissions (grants minus later revocations)
venues[].subDeployers[].user	string	Sub-deployer address
venues[].subDeployers[].variants	array of string	Delegated action variants, e.g. "registerStandaloneOutcomeFromTemplate", "settleOutcome", "settleQuestion"

{
  "venues": [
    {
      "venueName": "out",
      "deployer": "0x0c46eb73fae2816f219fcf11f50d6d3c59b5819e",
      "activatedAt": 1787992549143,
      "deactivatedAt": null,
      "isActive": true,
      "subDeployers": [
        {
          "user": "0xf1923927d7d2847191fb7ef8b1a16028aa5ae754",
          "variants": [
            "registerAndAssociateNamedOutcomeFromTemplate",
            "registerQuestionFromTemplate",
            "registerStandaloneOutcomeFromTemplate",
            "settleOutcome",
            "settleQuestion"
          ]
        }
      ]
    }
  ]
}