Skip to main content

market_lifecycle

publicchannel: market_lifecyclewss://api.staging.sphx.io/v1/ws

Venue-wide account-state and instrument-lifecycle transitions (numeric states). Public and unfiltered — clients typically ignore accounts other than their own. No subscribe params.

Subscribe​

{ "op": "subscribe", "channel": "market_lifecycle" }

No params — the channel is venue-wide.

Events​

account_state_change​

An account changed lifecycle state.

FieldTypeRequiredDescription
event_seqinteger · int64✓Cluster sequence number — monotonic; drives gap detection and REST/WS joins.
account_idinteger · int64✓
new_stateinteger✓Numeric account state (see the REST reference lookup tables).
Example frame
{
"channel": "market_lifecycle",
"event": "account_state_change",
"data": {
"event_seq": 1058,
"account_id": 7,
"new_state": 2
}
}

instrument_lifecycle​

An instrument changed lifecycle state.

FieldTypeRequiredDescription
event_seqinteger · int64✓Cluster sequence number — monotonic; drives gap detection and REST/WS joins.
instrument_idinteger · int64✓
new_stateinteger✓Numeric instrument lifecycle state.
Example frame
{
"channel": "market_lifecycle",
"event": "instrument_lifecycle",
"data": {
"event_seq": 1059,
"instrument_id": 1000,
"new_state": 2
}
}

funding_rate​

FieldTypeRequiredDescription
instrument_idinteger · int64✓
boundary_nsinteger · int64✓
rate_fp8integer · int64✓The settled rate (1e-8 per interval); 0 with zero totals = a skipped boundary.
premium_fp8integer · int64✓
interest_fp8integer · int64✓
total_paid_uusdcinteger · int64✓Σ payer debits this boundary.
dust_uusdcinteger · int64✓Rounding residue routed to the insurance fund.
holder_countinteger✓
skippedboolean✓
event_seqinteger · int64✓Cluster sequence number — monotonic; drives gap detection and REST/WS joins.
ts_nsinteger · int64✓
Example frame
{
"channel": "market_lifecycle",
"event": "funding_rate",
"data": {
"instrument_id": 1011,
"boundary_ns": 1790265600000000000,
"rate_fp8": -271235,
"premium_fp8": -321235,
"interest_fp8": 0,
"total_paid_uusdc": 4120900,
"dust_uusdc": 7,
"holder_count": 31,
"skipped": false,
"event_seq": 88123433,
"ts_ns": 1790265600125
}
}