Get event
curl --request GET \
--url https://relay.bayse.markets/v1/pm/events/{eventId}import requests
url = "https://relay.bayse.markets/v1/pm/events/{eventId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://relay.bayse.markets/v1/pm/events/{eventId}', 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://relay.bayse.markets/v1/pm/events/{eventId}",
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://relay.bayse.markets/v1/pm/events/{eventId}"
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://relay.bayse.markets/v1/pm/events/{eventId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://relay.bayse.markets/v1/pm/events/{eventId}")
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{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": true,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"minimumOrderAmount": 100,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
{
"error": "not_found",
"message": "Event not found",
"statusCode": 404
}
Trading
Get event
Get a specific prediction market event by ID
GET
/
v1
/
pm
/
events
/
{eventId}
Get event
curl --request GET \
--url https://relay.bayse.markets/v1/pm/events/{eventId}import requests
url = "https://relay.bayse.markets/v1/pm/events/{eventId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://relay.bayse.markets/v1/pm/events/{eventId}', 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://relay.bayse.markets/v1/pm/events/{eventId}",
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://relay.bayse.markets/v1/pm/events/{eventId}"
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://relay.bayse.markets/v1/pm/events/{eventId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://relay.bayse.markets/v1/pm/events/{eventId}")
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{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": true,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"minimumOrderAmount": 100,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
{
"error": "not_found",
"message": "Event not found",
"statusCode": 404
}
Authentication
Public — no authentication required. ProvideX-Public-Key for personalized data (watchlist status).
Path parameters
Query parameters
Example request
curl "https://relay.bayse.markets/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890?currency=NGN" \
-H "X-Public-Key: pk_live_abcdef123456"
const eventId = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
const response = await fetch(
`https://relay.bayse.markets/v1/pm/events/${eventId}?currency=NGN`,
{ headers: { 'X-Public-Key': 'pk_live_abcdef123456' } }
);
const event = await response.json();
import requests
event_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
resp = requests.get(
f'https://relay.bayse.markets/v1/pm/events/{event_id}',
params={'currency': 'NGN'},
headers={'X-Public-Key': 'pk_live_abcdef123456'},
)
event = resp.json()
req, _ := http.NewRequest(
"GET",
"https://relay.bayse.markets/v1/pm/events/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
nil,
)
q := req.URL.Query()
q.Add("currency", "NGN")
req.URL.RawQuery = q.Encode()
req.Header.Set("X-Public-Key", "pk_live_abcdef123456")
resp, _ := http.DefaultClient.Do(req)
Track status changes
Subscribe to Event and market status to receive notifications for this event and all its child markets. Refresh this endpoint when either entity changes, after reconnecting, and periodically while connected. A child market can resolve while the parent event remains open. To fetch several events in one request, use batch event lookup.Response
Returns a single event object. See List events for the full field reference — the response shape is identical.{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"slug": "super-eagles-afcon-2026",
"title": "Will Super Eagles qualify for AFCON 2026?",
"category": "sports",
"type": "single",
"engine": "AMM",
"status": "open",
"resolutionDate": "2025-11-20T00:00:00Z",
"closingDate": "2025-11-19T18:00:00Z",
"liquidity": 50000,
"totalVolume": 120000,
"totalOrders": 843,
"supportedCurrencies": ["USD", "NGN"],
"userWatchlisted": true,
"markets": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Will Super Eagles qualify?",
"status": "open",
"outcome1Id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"outcome1Label": "YES",
"outcome1Price": 0.72,
"outcome2Id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"outcome2Label": "NO",
"outcome2Price": 0.28,
"yesBuyPrice": 0.72,
"minimumOrderAmount": 100,
"noBuyPrice": 0.28,
"feePercentage": 2.0,
"totalOrders": 843,
"rules": "Resolves YES if Nigeria qualifies for AFCON 2026."
}
]
}
{
"error": "not_found",
"message": "Event not found",
"statusCode": 404
}