curl --request GET \
--url https://api.hypedexer.com/hip4/outcomes \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/hip4/outcomes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hypedexer.com/hip4/outcomes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hypedexer.com/hip4/outcomes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/hip4/outcomes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hypedexer.com/hip4/outcomes")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/hip4/outcomes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"outcome_id": 11,
"coin": "#11",
"name": "Canned Tuna",
"description": "Affordable tuna for bear markets",
"class": "",
"underlying": "",
"expiry": "",
"target_price": 0,
"period": "",
"side_specs": "[{\"name\":\"Yes\"},{\"name\":\"No\"}]",
"question_id": 1,
"quote_token": 0,
"block_time": "2026-03-29 23:12:55.308000000",
"question_name": "What will Hypurr eat the most of in Feb 2026?",
"question_description": "Hypurr has committed to weighing and recording daily food intake in a food journal.",
"total_fills": 2,
"total_volume": 21.4,
"unique_users": 2,
"venue": "",
"deployer": "",
"deployer_fee_scale": 0
},
{
"outcome_id": 31207,
"coin": "#31207",
"name": "HYPE above 100 on Sep 30?",
"description": "Settles to Yes if HYPE trades above 100 on 2026-09-30.",
"class": "",
"underlying": "",
"expiry": "",
"target_price": 0,
"period": "",
"side_specs": "[{\"name\":\"Yes\"},{\"name\":\"No\"}]",
"question_id": null,
"quote_token": 0,
"block_time": "2026-08-29 09:14:02.114000000",
"question_name": "",
"question_description": "",
"total_fills": 152,
"total_volume": 8412.7,
"unique_users": 37,
"venue": "hypurr-markets",
"deployer": "0x59900d101574c04a6b8a647feb3db1ab48eb320a",
"deployer_fee_scale": 1
}
]List prediction outcomes
Returns prediction outcome definitions with volume stats. Each outcome (e.g. “Canned Tuna”) has Yes/No sides and may belong to a question. Use question_id to get all outcomes for a question.
Since the permissionless-HIP4 upgrade, every market row carries venue, deployer and deployer_fee_scale attributing it to its provider. Oracle-emitted (legacy) markets have venue = "", deployer = "" and deployer_fee_scale = 0 — see Permissionless providers and the oracle convention.
Also available as /hip4/markets (alias).
curl --request GET \
--url https://api.hypedexer.com/hip4/outcomes \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/hip4/outcomes"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hypedexer.com/hip4/outcomes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hypedexer.com/hip4/outcomes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/hip4/outcomes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hypedexer.com/hip4/outcomes")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/hip4/outcomes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"outcome_id": 11,
"coin": "#11",
"name": "Canned Tuna",
"description": "Affordable tuna for bear markets",
"class": "",
"underlying": "",
"expiry": "",
"target_price": 0,
"period": "",
"side_specs": "[{\"name\":\"Yes\"},{\"name\":\"No\"}]",
"question_id": 1,
"quote_token": 0,
"block_time": "2026-03-29 23:12:55.308000000",
"question_name": "What will Hypurr eat the most of in Feb 2026?",
"question_description": "Hypurr has committed to weighing and recording daily food intake in a food journal.",
"total_fills": 2,
"total_volume": 21.4,
"unique_users": 2,
"venue": "",
"deployer": "",
"deployer_fee_scale": 0
},
{
"outcome_id": 31207,
"coin": "#31207",
"name": "HYPE above 100 on Sep 30?",
"description": "Settles to Yes if HYPE trades above 100 on 2026-09-30.",
"class": "",
"underlying": "",
"expiry": "",
"target_price": 0,
"period": "",
"side_specs": "[{\"name\":\"Yes\"},{\"name\":\"No\"}]",
"question_id": null,
"quote_token": 0,
"block_time": "2026-08-29 09:14:02.114000000",
"question_name": "",
"question_description": "",
"total_fills": 152,
"total_volume": 8412.7,
"unique_users": 37,
"venue": "hypurr-markets",
"deployer": "0x59900d101574c04a6b8a647feb3db1ab48eb320a",
"deployer_fee_scale": 1
}
]Authorizations
Include in every request header as X-API-Key: <your_key>.
Query Parameters
Filter by outcome ID
Filter by question ID — returns all outcomes for that question
Filter by class (e.g. priceBinary)
Filter by underlying asset (e.g. BTC, HYPE)
x <= 10000Response
OK
Unique outcome identifier
Prediction market coin (e.g. #11)
Outcome name (e.g. Canned Tuna, Recurring)
Outcome description or structured metadata for priceBinary
Market class (e.g. priceBinary). Empty for custom outcomes.
Underlying asset (e.g. BTC, HYPE). Empty for custom outcomes.
Expiry datetime (e.g. 20260329-0500)
Target price for priceBinary outcomes
Period (e.g. 15m, 1d)
JSON array of side names (e.g. [{"name":"Yes"},{"name":"No"}])
Parent question ID (null if standalone)
Quote token index
Creation timestamp
Parent question name (empty if no question)
Parent question description
Total number of fills on this outcome
Total traded volume in USD (sum of px * sz)
Number of unique users who traded this outcome
Provider venue name. Empty string for oracle-emitted (legacy) markets — see the oracle convention.
Deployer address operating the venue. Empty string when venue is empty.
Deployer fee scale for this market. 0 when not applicable.