settledOutcome

Get the settlement spec and result for a single prediction market outcome.

Returns the settlement spec and result for a single outcome by its outcome index. Returns null if the outcome is unknown or not yet settled.

Field	Type	Description
type	string	Must be "settledOutcome"
outcome	int	Outcome index (required)

Request

cURL

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

Python

import requests
import os
import json

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'settledOutcome',
        'outcome': 0
    },
    headers={
        'Authorization': f'Bearer {os.environ["HYDROMANCER_API_KEY"]}',
        'Content-Type': 'application/json'
    }
)
print(json.dumps(response.json(), indent=2))

Javascript

import axios from 'axios';

const response = await axios.post(
  'https://api.hydromancer.xyz/info',
  {
    type: 'settledOutcome',
    outcome: 0
  },
  {
    headers: {
      'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

console.log(JSON.stringify(response.data, null, 2));

---

Response Fields

Returns null if the outcome is unknown or not yet settled.

Field	Type	Description
spec.outcome	int	Outcome index
spec.name	string	Outcome name
spec.description	string	Encoded outcome spec (e.g. "class:priceBinary|underlying:BTC|expiry:20260503-0600|targetPrice:78213|period:1d")
spec.sideSpecs	array	List of { name } objects, one per side (e.g. Yes/No)
spec.quoteToken	string	Quote token for the outcome market
settleFraction	string	Settlement fraction for the winning side
details	string	Settlement details (e.g. "price:78212.4")

Response

{
  "spec": {
    "outcome": 0,
    "name": "Recurring",
    "description": "class:priceBinary|underlying:BTC|expiry:20260503-0600|targetPrice:78213|period:1d",
    "sideSpecs": [
      { "name": "Yes" },
      { "name": "No" }
    ],
    "quoteToken": "USDH"
  },
  "settleFraction": "0.0",
  "details": "price:78212.4"
}