Skip to content
API reference

Service health

GET
/v2/health
curl --request GET \
--url https://api.hyperstream.dev/v2/health

Global liveness of the order pipeline. Not your readiness: use /v2/params for that.

Healthy.

Media typeapplication/json

Liveness of the order pipeline, global across integrators.

object
status
required

degraded when the order store could not be read. The response is then a 503 with counts: null.

string
Allowed values: ok degraded
counts
required
Any of:
object
totalOrders
required

Every order ever built.

integer
pending
required

pending_deposit orders still inside their deposit window.

integer
deposited
required
integer
published
required
integer
partiallyFilled
required
integer
terminalChain
required
integer
withdrawn
required

withdrawn_on_hub: settled, delivery not yet fully recorded.

integer
delivered
required
integer
deliveryFailed
required
integer
stuck
required

Mid-flight orders that automated recovery has handed to an operator.

integer
abandoned
required

Orders whose deposit never arrived before expiry. No funds moved.

integer
undelivered
required

Settled 12h+ ago with a payout or refund leg still unrecorded. Counted inside withdrawn, not beside it.

integer
lastBuildAt
required
Any of:
integer
lastWithdrawnAt
required
Any of:
integer

Example

{
"status": "ok",
"counts": {
"totalOrders": 1250,
"pending": 3,
"deposited": 1,
"published": 4,
"partiallyFilled": 1,
"terminalChain": 0,
"withdrawn": 12,
"delivered": 1180,
"deliveryFailed": 0,
"stuck": 0,
"abandoned": 49,
"undelivered": 0
},
"lastBuildAt": 1786999700,
"lastWithdrawnAt": 1786999790
}

Unhandled failure. Retry once, then escalate with the x-request-id response header.

Media typeapplication/json

Maintenance, a malformed JSON body, or an unhandled failure. Carries message, not error.

object
message
required
string
name
required

MaintenanceException (503), BadRequestException (malformed JSON) or InternalErrorException (500).

string

Example

{
"message": "Internal Error",
"name": "InternalErrorException"
}

The order store could not be read.

Media typeapplication/json

Liveness of the order pipeline, global across integrators.

object
status
required

degraded when the order store could not be read. The response is then a 503 with counts: null.

string
Allowed values: ok degraded
counts
required
Any of:
object
totalOrders
required

Every order ever built.

integer
pending
required

pending_deposit orders still inside their deposit window.

integer
deposited
required
integer
published
required
integer
partiallyFilled
required
integer
terminalChain
required
integer
withdrawn
required

withdrawn_on_hub: settled, delivery not yet fully recorded.

integer
delivered
required
integer
deliveryFailed
required
integer
stuck
required

Mid-flight orders that automated recovery has handed to an operator.

integer
abandoned
required

Orders whose deposit never arrived before expiry. No funds moved.

integer
undelivered
required

Settled 12h+ ago with a payout or refund leg still unrecorded. Counted inside withdrawn, not beside it.

integer
lastBuildAt
required
Any of:
integer
lastWithdrawnAt
required
Any of:
integer

Example

{
"status": "degraded",
"counts": null,
"lastBuildAt": null,
"lastWithdrawnAt": null
}