info (outcomeMeta)
curl --request POST \
--url https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info \
--header 'Content-Type: application/json' \
--data '
{
"type": "outcomeMeta"
}
'import requests
url = "https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info"
payload = { "type": "outcomeMeta" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({type: 'outcomeMeta'})
};
fetch('https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info', 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://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'outcomeMeta'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info"
payload := strings.NewReader("{\n \"type\": \"outcomeMeta\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"outcomeMeta\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"outcomeMeta\"\n}"
response = http.request(request)
puts response.read_body{
"outcomes": [
{
"outcome": 33246,
"name": "Recurring",
"description": "class:priceBinary|underlying:BTC|expiry:20261113-0600|targetPrice:73567|period:1d",
"sideSpecs": [
{
"name": "Yes"
},
{
"name": "No"
}
],
"quoteToken": "USDC"
},
{
"outcome": 32843,
"name": "template:binaryPrice",
"description": "perp:xyz:SNDK|priceDescription:xyz:SNDK-USDC perp mark|seconds:60|threshold:977.77|time:20261112-2100",
"sideSpecs": [
{
"name": "template:Yes"
},
{
"name": "template:No"
}
],
"quoteToken": "USDC",
"venue": "out",
"deployerFeeScale": "1.0"
}
],
"questions": [
{
"question": 620,
"name": "template:sportsContestResult",
"description": "competition:UEFA Nations League|contestType:Match|countedPlay:regulation time, 90 minutes plus stoppage time|officialSource:Union of European Football Associations|participantA:Bulgaria|participantB:Iceland|resolutionDeadline:20261120-1945|scheduledStart:20261113-1945|season:2026/27|sport:Soccer|stage:C, Matchday 5",
"fallbackOutcome": 29101,
"namedOutcomes": [
29102,
29103,
29104
],
"settledNamedOutcomes": []
}
],
"deployers": [
{
"deployer": "0x08e9c89f46dccee91bdb85c6532eb93a4c335efe",
"venue": "skew",
"subDeployers": [
[
"settleOutcome",
[
"0x1c867861e0cffb0eba07d9d94f716189c130dac6"
]
]
]
}
],
"feeScale": "1.0"
}Hyperliquid node API
outcomeMeta | Hyperliquid info
The info endpoint with type: “outcomeMeta” retrieves the live HIP-4 outcome markets, multi-outcome questions, and market deployers on the Hyperliquid exchange.
POST
/
mt_c524ad9781ae5dccd9ac6f5b0370e
/
info
info (outcomeMeta)
curl --request POST \
--url https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info \
--header 'Content-Type: application/json' \
--data '
{
"type": "outcomeMeta"
}
'import requests
url = "https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info"
payload = { "type": "outcomeMeta" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({type: 'outcomeMeta'})
};
fetch('https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info', 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://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'outcomeMeta'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info"
payload := strings.NewReader("{\n \"type\": \"outcomeMeta\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"outcomeMeta\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"outcomeMeta\"\n}"
response = http.request(request)
puts response.read_body{
"outcomes": [
{
"outcome": 33246,
"name": "Recurring",
"description": "class:priceBinary|underlying:BTC|expiry:20261113-0600|targetPrice:73567|period:1d",
"sideSpecs": [
{
"name": "Yes"
},
{
"name": "No"
}
],
"quoteToken": "USDC"
},
{
"outcome": 32843,
"name": "template:binaryPrice",
"description": "perp:xyz:SNDK|priceDescription:xyz:SNDK-USDC perp mark|seconds:60|threshold:977.77|time:20261112-2100",
"sideSpecs": [
{
"name": "template:Yes"
},
{
"name": "template:No"
}
],
"quoteToken": "USDC",
"venue": "out",
"deployerFeeScale": "1.0"
}
],
"questions": [
{
"question": 620,
"name": "template:sportsContestResult",
"description": "competition:UEFA Nations League|contestType:Match|countedPlay:regulation time, 90 minutes plus stoppage time|officialSource:Union of European Football Associations|participantA:Bulgaria|participantB:Iceland|resolutionDeadline:20261120-1945|scheduledStart:20261113-1945|season:2026/27|sport:Soccer|stage:C, Matchday 5",
"fallbackOutcome": 29101,
"namedOutcomes": [
29102,
29103,
29104
],
"settledNamedOutcomes": []
}
],
"deployers": [
{
"deployer": "0x08e9c89f46dccee91bdb85c6532eb93a4c335efe",
"venue": "skew",
"subDeployers": [
[
"settleOutcome",
[
"0x1c867861e0cffb0eba07d9d94f716189c130dac6"
]
]
]
}
],
"feeScale": "1.0"
}The
For example, YES (side
info endpoint with type: "outcomeMeta" retrieves the live HIP-4 outcome markets, multi-outcome questions, and market deployers on the Hyperliquid exchange. Outcome markets are fully collateralized binary contracts that settle within a fixed range — the primitive that powers prediction markets and bounded options-like instruments on Hyperliquid.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
Parameters
type(string, required) — Must be"outcomeMeta"
Returns
Returns an object with four fields:outcomes, questions, deployers, and feeScale.
Outcomes
An array of live outcome markets. Each entry contains:outcome(integer) — Outcome id. Used together with the side index to derive the asset encoding.name(string) — Market name:"Recurring"for recurring binary markets, or the template name (for example,"template:binaryPrice") for markets created by a deployer.description(string) — Pipe-separatedkey:valuestring. Recurring binaries carryclass,underlying,expiry,targetPrice, andperiod(for example,"class:priceBinary|underlying:BTC|expiry:20261113-0600|targetPrice:73567|period:1d"). Deployer markets carry their template parameters.sideSpecs(array) — Two-element array describing the YES (index 0) and NO (index 1) sides. Each element has anamefield.quoteToken(string) — Token the outcome settles in. Every current market settles in"USDC".venue(string) — Venue of the deployer that created the market. Absent on recurring markets.deployerFeeScale(string) — Fee scale set for a deployer market, as a decimal string. Absent on some markets.
Questions
An array of multi-outcome questions, both recurring (such as the daily BTC price bucket) and created by deployers. Each entry contains:question(integer) — Question id.name(string) — Question text.description(string) — Free-form description.fallbackOutcome(integer) — Outcome id used if none of the named outcomes matches.namedOutcomes(array of integers) — Outcome ids for the named legs.settledNamedOutcomes(array of integers) — Outcome ids that have already settled.
Deployers and fee scale
deployers(array) — Market deployers. Each entry hasdeployer(address),venue(venue name), andsubDeployers, a list of[action, [addresses]]pairs naming the accounts a deployer delegates each action to.feeScale(string) — Global outcome market fee scale, as a decimal string.
Asset encoding
outcomeMeta does not return per-side coin strings or asset ids. Compute them client-side from outcome and side (0 for YES, 1 for NO):
encoding = 10 * outcome + side
trade coin = "#<encoding>" # for /info l2Book and Exchange.order(...)
balance coin = "+<encoding>" # for spotClearinghouseState
asset id = 100_000_000 + encoding
0) on outcome 1 has the encoding 10, the trade coin #10, the balance coin +10, and the asset id 100_000_010. Recurring markets get a new outcome id for every instance, so read the current id from outcomeMeta rather than hardcoding it.
See the full guide at Trading HIP-4 outcome markets on Hyperliquid for the rest of the trading flow.
Example request
curl -X POST \
-H "Content-Type: application/json" \
-d '{"type": "outcomeMeta"}' \
https://hyperliquid-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/info
from hyperliquid.info import Info
# skip_ws=True avoids opening a WebSocket connection for this REST call
info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)
# The SDK has no typed wrapper for "outcomeMeta", so post the request directly.
# Every typed Info method is a thin wrapper over this same post(...) call.
outcome_meta = info.post("/info", {"type": "outcomeMeta"})
print(outcome_meta["outcomes"])
print(outcome_meta["questions"])
import * as hl from "@nktkas/hyperliquid";
// apiUrl points the transport at a custom server (your Chainstack endpoint)
const transport = new hl.HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
const client = new hl.InfoClient({ transport });
const data = await client.outcomeMeta();
console.log(data.outcomes);
console.log(data.questions);
Use your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.
Use cases
- Market discovery — enumerate every live outcome market and its side names before placing orders.
- Settlement parser — read
descriptionto extract theexpiryandtargetPricefor recurring binary markets, or the template parameters for deployer markets. - Multi-outcome markets — list the named legs of a
questionand their settled status. - Inventory reconciliation — track which
outcomeids are still live so you can mark settled positions out of your book.
Body
application/json
Response
200 - application/json
Live HIP-4 outcome markets and categorical questions
Last modified on November 12, 2026
Was this page helpful?