HIP-4 (Outcome Markets) binary contracts resolve at expiry against a reference price. This endpoint returns the settlement record for a specific outcome market by index, including the market spec, the payout fraction for the Yes side, and the reference price used to determine the result. Returns null if the outcome has not yet settled or the index does not exist.

Use the outcomeMeta endpoint to look up active market indices and their descriptions before querying settlement.

Parameters

type

string

REQUIRED

Request type identifier. Must be 'settledOutcome'

outcome

integer

REQUIRED

Zero-based index of the outcome market to query. Use the outcomeMeta endpoint to list active markets and their indices.

Returns

(root)

object | null

Settlement record for the requested outcome, or null if the outcome has not settled or the index does not exist.

spec

object

The market specification, mirroring the structure returned by outcomeMeta for this outcome.

outcome

integer

Zero-based index of this outcome market.

name

string

Human-readable market name (e.g., 'Recurring').

description

string

Encodes the outcome type, matching the format returned by outcomeMeta. One of: (1) 'class:priceBinary|underlying:ASSET|expiry:YYYYMMDD-HHMM|targetPrice:N|period:Nd': binary outcome, expiry in UTC; (2) 'other': fallback outcome for a multi-price question; (3) 'index:N': Nth named price-bucket outcome within a question (zero-indexed).

sideSpecs

array

Array of side metadata objects, one per outcome side.

name

string

Label for this side (e.g., 'Yes' or 'No').

quoteToken

string

(Optional) Quote token symbol for the outcome market (e.g., 'USDH').

settleFraction

string

Payout fraction for side 0 (Yes) as a decimal string. '1.0' means side 0 won (Yes resolved true); '0.0' means side 0 lost (No resolved true).

details

string

Settlement detail string containing the reference price used to resolve the market (e.g., 'price:78212.4').

Request

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"settledOutcome","outcome":0}'
5

1
curl https://docs-demo.hype-mainnet.quiknode.pro/evm \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"type":"settledOutcome","outcome":0}'
5

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "settledOutcome",
6
  "outcome": 0
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "type": "settledOutcome",
6
  "outcome": 0
7
});
8

9
var requestOptions = {
10
  method: 'POST',
11
  headers: myHeaders,
12
  body: raw,
13
  redirect: 'follow'
14
};
15

16
fetch("https://docs-demo.hype-mainnet.quiknode.pro/evm", requestOptions)
17
  .then(response => response.text())
18
  .then(result => console.log(result))
19
  .catch(error => console.log('error', error));
20

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "type": "settledOutcome",
8
  "outcome": 0
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

14
response = requests.request("POST", url, headers=headers, data=payload)
15

16
print(response.text)
17

1
import requests
2
import json
3

4
url = "https://docs-demo.hype-mainnet.quiknode.pro/evm"
5

6
payload = json.dumps({
7
  "type": "settledOutcome",
8
  "outcome": 0
9
})
10
headers = {
11
  'Content-Type': 'application/json'
12
}
13

14
response = requests.request("POST", url, headers=headers, data=payload)
15

16
print(response.text)
17

1
require 'uri'
2
require 'net/http'
3
require 'json'
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
http = Net::HTTP.new(url.host, url.port)
8
http.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = 'application/json'
12
request.body = JSON.dump({
13
  "type": "settledOutcome",
14
  "outcome": 0
15
})
16

17
response = http.request(request)
18
puts response.read_body
19

1
require 'uri'
2
require 'net/http'
3
require 'json'
4

5
url = URI("https://docs-demo.hype-mainnet.quiknode.pro/evm")
6

7
http = Net::HTTP.new(url.host, url.port)
8
http.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = 'application/json'
12
request.body = JSON.dump({
13
  "type": "settledOutcome",
14
  "outcome": 0
15
})
16

17
response = http.request(request)
18
puts response.read_body
19

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free