outcomeVenueStats
Market counts and lifetime trading stats per HIP-4 venue, plus validator-deployed markets.
Returns one entry per permissionless outcome venue: how many of its outcomes and questions are currently registered or already settled, plus trading stats across every outcome it deployed. Markets registered by validator quorum belong to no venue and are reported together as one entry named "validator".
POST Request
type
string
Must be "outcomeVenueStats"
venue
string (optional)
Only this venue (2–4 ASCII letters, case-insensitive), or "validator" for validator-deployed markets; absent returns all
limit
integer (optional)
Max venues returned, in venueName order. Default 20, maximum 100
curl -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "outcomeVenueStats"}'
# Only validator-deployed markets
curl -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "outcomeVenueStats", "venue": "validator"}'import requests
import os
response = requests.post(
'https://api.hydromancer.xyz/info',
json={'type': 'outcomeVenueStats'},
headers={'Authorization': f"Bearer {os.environ['HYDROMANCER_API_KEY']}"},
)
print(response.json())Response
Responses are cached for up to 30 seconds. Trading stats cover the venue's whole history, across both open and settled outcomes. Each chain match is counted once (quantity metrics take the Buy side; every match emits one Buy and one Sell). Settlement and the four HIP-4 conversion ops (Split Outcome, Negate Outcome, Merge Outcome, Merge Question) are excluded from all metrics.
venues
array
Venues with at least one market, ordered by venueName
venues[].venueName
string
Venue name claimed via activateOutcomeDeployer, or "validator" for markets registered by validator quorum
venues[].registeredOutcomes
integer
Outcomes registered and not yet settled, question children included
venues[].settledOutcomes
integer
Outcomes settled so far, question children included
venues[].registeredQuestions
integer
Questions registered and not yet settled
venues[].settledQuestions
integer
Questions settled so far
venues[].trades
integer
Orderbook matches across the venue's outcomes
venues[].uniqueTraders
integer
Distinct users that traded any of the venue's outcomes
venues[].volumeNotional
string
Sum of px * sz across all matches
venues[].volumeContracts
string
Sum of sz across all matches
venues[].firstTrade
integer
Earliest orderbook fill, ms since epoch; 0 without trades
venues[].lastTrade
integer
Latest orderbook fill, ms since epoch; 0 without trades
Last updated