curl --request GET \
--url https://hip4-api.totalis.trade/v1/marketsimport requests
url = "https://hip4-api.totalis.trade/v1/markets"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://hip4-api.totalis.trade/v1/markets', 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://hip4-api.totalis.trade/v1/markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://hip4-api.totalis.trade/v1/markets"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://hip4-api.totalis.trade/v1/markets")
.asString();require 'uri'
require 'net/http'
url = URI("https://hip4-api.totalis.trade/v1/markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"items": [
{
"outcome_id": "1209",
"native_question_id": null,
"title": "HYPE touches 100 by 20261001-0000",
"state": "ACTIVE",
"result": {
"availability": "AVAILABLE",
"result_state": "UNRESOLVED"
},
"metadata_revision": "6100",
"eligibility": {
"state": "ENABLED"
},
"combo": {
"state": "OPEN"
},
"deployer": {
"name": "Hyperliquid",
"address": null
},
"category": "Crypto",
"subcategory": "other",
"sides": [
{
"side": "YES",
"coin": "#12090",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "240800000000000000",
"best_bid": "238600000000000000",
"best_ask": "243000000000000000",
"last_trade": "240000000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "240800000000000000",
"chance_basis": "MID",
"mark": "240800000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.72902044Z"
}
},
{
"side": "NO",
"coin": "#12091",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "759200000000000000",
"best_bid": "757000000000000000",
"best_ask": "761400000000000000",
"last_trade": "760000000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "759200000000000000",
"chance_basis": "MID",
"mark": "759200000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.72902044Z"
}
}
],
"dates": {
"event": null,
"result_by": null,
"resolves_after": null,
"scheduled_event_at": null,
"observation_ends_at": "1790812800",
"market_class": "PRICE_TOUCH"
}
},
{
"outcome_id": "1210",
"native_question_id": null,
"title": "BTC above 100000 at 20261001-0000?",
"state": "ACTIVE",
"result": {
"availability": "AVAILABLE",
"result_state": "UNRESOLVED"
},
"metadata_revision": "6100",
"eligibility": {
"state": "ENABLED"
},
"combo": {
"state": "OPEN"
},
"deployer": {
"name": "Hyperliquid",
"address": null
},
"category": "Crypto",
"subcategory": "btc",
"sides": [
{
"side": "YES",
"coin": "#12100",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "6030000000000000",
"best_bid": "6010000000000000",
"best_ask": "6050000000000000",
"last_trade": "6030000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "6030000000000000",
"chance_basis": "MID",
"mark": "6030000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.751601549Z"
}
},
{
"side": "NO",
"coin": "#12101",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "993970000000000000",
"best_bid": "993950000000000000",
"best_ask": "993990000000000000",
"last_trade": "993970000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "993970000000000000",
"chance_basis": "MID",
"mark": "993970000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.751601549Z"
}
}
],
"dates": {
"event": null,
"result_by": null,
"resolves_after": null,
"scheduled_event_at": null,
"observation_ends_at": "1790812800",
"market_class": "PRICE_BINARY"
}
}
],
"catalog_generation": "6100",
"next_cursor": "eyJnIjo2MTAwLCJhIjoxMjEwLCJrIjoibWFya2V0In0",
"has_more": true
}{
"error": {
"code": "INVALID_QUERY",
"field_violations": [
{
"code": "REQUIRED",
"field": "<string>"
}
],
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retry": "NEVER"
}
}{
"error": {
"code": "MARKET_DATA_UNAVAILABLE",
"field_violations": [
{
"code": "REQUIRED",
"field": "<string>"
}
],
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retry": "BACKOFF"
}
}List markets
List active markets as one flat list, one HIP-4 outcome per item; GET /v1/discovery groups them under their questions’ titles.
No API key required.
curl --request GET \
--url https://hip4-api.totalis.trade/v1/marketsimport requests
url = "https://hip4-api.totalis.trade/v1/markets"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://hip4-api.totalis.trade/v1/markets', 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://hip4-api.totalis.trade/v1/markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://hip4-api.totalis.trade/v1/markets"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://hip4-api.totalis.trade/v1/markets")
.asString();require 'uri'
require 'net/http'
url = URI("https://hip4-api.totalis.trade/v1/markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"items": [
{
"outcome_id": "1209",
"native_question_id": null,
"title": "HYPE touches 100 by 20261001-0000",
"state": "ACTIVE",
"result": {
"availability": "AVAILABLE",
"result_state": "UNRESOLVED"
},
"metadata_revision": "6100",
"eligibility": {
"state": "ENABLED"
},
"combo": {
"state": "OPEN"
},
"deployer": {
"name": "Hyperliquid",
"address": null
},
"category": "Crypto",
"subcategory": "other",
"sides": [
{
"side": "YES",
"coin": "#12090",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "240800000000000000",
"best_bid": "238600000000000000",
"best_ask": "243000000000000000",
"last_trade": "240000000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "240800000000000000",
"chance_basis": "MID",
"mark": "240800000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.72902044Z"
}
},
{
"side": "NO",
"coin": "#12091",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "759200000000000000",
"best_bid": "757000000000000000",
"best_ask": "761400000000000000",
"last_trade": "760000000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "759200000000000000",
"chance_basis": "MID",
"mark": "759200000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.72902044Z"
}
}
],
"dates": {
"event": null,
"result_by": null,
"resolves_after": null,
"scheduled_event_at": null,
"observation_ends_at": "1790812800",
"market_class": "PRICE_TOUCH"
}
},
{
"outcome_id": "1210",
"native_question_id": null,
"title": "BTC above 100000 at 20261001-0000?",
"state": "ACTIVE",
"result": {
"availability": "AVAILABLE",
"result_state": "UNRESOLVED"
},
"metadata_revision": "6100",
"eligibility": {
"state": "ENABLED"
},
"combo": {
"state": "OPEN"
},
"deployer": {
"name": "Hyperliquid",
"address": null
},
"category": "Crypto",
"subcategory": "btc",
"sides": [
{
"side": "YES",
"coin": "#12100",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "6030000000000000",
"best_bid": "6010000000000000",
"best_ask": "6050000000000000",
"last_trade": "6030000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "6030000000000000",
"chance_basis": "MID",
"mark": "6030000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.751601549Z"
}
},
{
"side": "NO",
"coin": "#12101",
"reference": {
"availability": "AVAILABLE",
"quality": "BOOK_MID",
"value": "993970000000000000",
"best_bid": "993950000000000000",
"best_ask": "993990000000000000",
"last_trade": "993970000000000000",
"last_trade_at": "2026-09-26T19:58:41.512Z",
"chance": "993970000000000000",
"chance_basis": "MID",
"mark": "993970000000000000",
"scale": "1000000000000000000",
"freshness": "FRESH",
"received_at": "2026-09-26T19:59:09.751601549Z"
}
}
],
"dates": {
"event": null,
"result_by": null,
"resolves_after": null,
"scheduled_event_at": null,
"observation_ends_at": "1790812800",
"market_class": "PRICE_BINARY"
}
}
],
"catalog_generation": "6100",
"next_cursor": "eyJnIjo2MTAwLCJhIjoxMjEwLCJrIjoibWFya2V0In0",
"has_more": true
}{
"error": {
"code": "INVALID_QUERY",
"field_violations": [
{
"code": "REQUIRED",
"field": "<string>"
}
],
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retry": "NEVER"
}
}{
"error": {
"code": "MARKET_DATA_UNAVAILABLE",
"field_violations": [
{
"code": "REQUIRED",
"field": "<string>"
}
],
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retry": "BACKOFF"
}
}Query Parameters
Platform taxonomy subcategory slug. The cursor is bound to this filter.
nba, ncaa, nfl, nhl, mlb, ufc, lol, counter_strike, epl, ucl, uel, efl, copa_del_rey, dfb_pokal, la_liga, serie_a, bundesliga, ligue_1, liga_portugal, super_lig, nations_league, world_cup, f1, ipl, cricket, transfers, btc, eth, sol, hype, up_down, stocks, indices, etfs, earnings, rates, inflation, commodities, fx, usa, global, other Keep only markets whose current eligibility.state is this value: ENABLED for markets that accept new positions now, DISABLED for the rest. Eligibility is live, so a market can change state between pages. The filter applies after paging, so a page can be short or empty while has_more is true; next_cursor being null is the only terminal signal. The cursor is bound to this filter.
ENABLED, DISABLED Response
One page of active markets in one flat list, not grouped by question. Each market is one HIP-4 outcome with its YES and NO sides, its own title and its native_question_id, but not the question's title; fallback and settled outcomes are left out. A listed market is not a promise that an RFQ on it will be quoted or accepted.
Was this page helpful?

