System Status

Liveness / degraded-mode snapshot. Public, unauthenticated.

curl --request GET \
  --url https://api.darknyx.example.com/system/status

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/system/status",
  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://api.darknyx.example.com/system/status"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.darknyx.example.com/system/status")

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

{
  "degraded": true,
  "matcher_running": true,
  "settle_enabled": true,
  "oracle_configured": true,
  "oracle_mode": "pyth-router-quorum-v1",
  "oracle_max_age_ms": 123,
  "current_slot": 123,
  "version": "<string>"
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

TL;DRGET /system/status is a public readiness snapshot: is matching running, is settlement wired, is an oracle attached, and what slot the engine is on. A degraded flag tells you, in one boolean, whether to back off before you hit a write failure.

GET /system/status

Public, with no authentication.

Response

{
  "degraded": false,
  "matcher_running": true,
  "settle_enabled": true,
  "oracle_configured": true,
  "current_slot": 309482113,
  "version": "…"
}

Field	Type	Description
`degraded`	boolean	`true` when settlement is unavailable, global readiness fails, or at least one market is paused.
`matcher_running`	boolean	At least one market can currently accept and match orders.
`settle_enabled`	boolean	The on-chain settlement pipeline is wired (matches will settle).
`oracle_configured`	boolean	A price oracle is attached (the clearing-price reference).
`current_slot`	integer	The engine’s current view of the Solana slot.
`version`	string	The running engine’s build version.

When degradation occurs

The venue is degraded when a core subsystem is unavailable: the matching tick is not running, the settlement pipeline is not wired, or the finalized governance/signer view no longer matches the boot-approved configuration. On a multi-market venue, a governed-market mismatch pauses new trading venue-wide rather than leaving some books running against uncertain authority. An oracle failure is narrower: it pauses only markets bound to the affected feed. In that partial state degraded is true, matcher_running can remain true, and each /instruments entry reports its own trading_enabled value. Under a venue-wide readiness failure, new place and modify operations fail closed with 503 Service Unavailable for every market. Under market-local oracle degradation, only place/modify for the affected market fails; a healthy symbol whose own trading_enabled remains true can continue even while the venue-level degraded summary is true. Cancels, authenticated reads, and reconciliation continue so a trader can reduce risk and the engine can resolve already-pending settlements.

How it manifests

Surface	Behavior under degradation
REST order management	New place/modify may return HTTP `503` with stable code `5001`; cancel remains available. Reads (`/instruments`, `/transparency`, `/tree/`) generally remain available, except a diverged tree shard fails its `/tree/` reads closed with `5002`.
WebSocket trading	`order.place` / `order.modify` may return an `error` with `code: 5001`; cancellation remains available.
`/health`	Still returns `200` (the engine process is up), which is why `/system/status` is the better readiness signal for a trading client.

Best practices

Use both readiness levels. Check /system/status for venue health, then the chosen /instruments/{symbol} entry’s trading_enabled value. Always handle a racing 503 from place/modify. Do not block a healthy symbol merely because another market makes the venue-level degraded summary true.
Use it, not /health, for readiness. /health answers “is the process up”; /system/status answers “can I trade right now.”
Back off and poll. On a 503, refresh /system/status plus the requested instrument. Resume that symbol when its own trading_enabled is true; do not wait for degraded=false when only another market remains paused. A venue-wide failure keeps every instrument disabled until global readiness recovers.
Surface it. It is public and leaks nothing, so it is safe to show on a status page or wire into client-side health checks.

Response

Engine status snapshot.

degraded

boolean

required

true when any market is paused or matching/governance/settlement readiness is down.

matcher_running

boolean

required

true when at least one configured market can accept and match new orders.

settle_enabled

boolean

required

The on-chain settle pipeline is wired.

oracle_configured

boolean

required

An oracle cache (clearing-price reference) is attached.

oracle_mode

enum<string> | null

required

Versioned oracle source selected exclusively at boot.

Available options:

pyth-router-quorum-v1,

pyth-solana-push-v1,

null

oracle_max_age_ms

integer<uint64> | null

required

Source-specific signed-price age budget.

current_slot

integer<uint64>

required

version

string

required

⌘I

Liveness / degraded-mode snapshot. Public, unauthenticated.

curl --request GET \
  --url https://api.darknyx.example.com/system/status

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/system/status",
  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://api.darknyx.example.com/system/status"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.darknyx.example.com/system/status")

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

{
  "degraded": true,
  "matcher_running": true,
  "settle_enabled": true,
  "oracle_configured": true,
  "oracle_mode": "pyth-router-quorum-v1",
  "oracle_max_age_ms": 123,
  "current_slot": 123,
  "version": "<string>"
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

Getting Started

System

Account

Instruments

Orders

Settlement

Tree

WebSocket

GET /system/status

Response

When degradation occurs

How it manifests

Best practices

Response

​GET /system/status

​Response

​When degradation occurs

​How it manifests

​Best practices

Response

GET /system/status

Response

When degradation occurs

How it manifests

Best practices